Commit Graph

49 Commits

Author SHA1 Message Date
mutron3k 96e02159c6
Update README.md
fixing 15 broken links

Signed-off-by: mutron3k <asloan7@gmail.com>
2023-09-28 14:44:56 -04:00
Max Jonas Werner 91a26c1675
Align docs structure with other controllers
In order to streamline the docs across all controllers, the CRD spec
file name is pluralized. This lets us better automate docs generation
from CRD specs.

refs fluxcd/website#1577

Signed-off-by: Max Jonas Werner <mail@makk.es>
2023-07-21 17:06:04 +02:00
Stefan Prodan 0e222c9c83
docs: Document the CommonMetadata field
Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2023-03-29 11:25:19 +03:00
Hidde Beydals 6bfc4e459d spec: change revisions in examples to RFC-0005 fmt
Signed-off-by: Hidde Beydals <hello@hidde.co>
2023-02-17 13:08:10 +01:00
Stefan Prodan 27328fbd9a
Allow force apply to be configured in metadata
Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2023-01-27 13:14:51 +02:00
Stefan Prodan b7c4691314
Release v0.32.0
Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2022-12-20 17:05:01 +02:00
Somtochi Onyekwere 3ad92a27d8 Add note on atomic fields
Signed-off-by: Somtochi Onyekwere <somtochionyekwere@gmail.com>
2022-12-07 15:44:32 +01:00
Kristian Klausen b25dea8366 Add support for Kustomize components
Fix #753

Signed-off-by: Kristian Klausen <kristian@klausen.dk>
2022-12-03 00:04:14 +01:00
Stefan Prodan 3e935d0b8f
Refactor: Remove docs which overlap with Flux website
Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2022-10-19 18:23:55 +03:00
Stefan Prodan 2f81a3966b
Add Reconciling status condition to API docs
Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2022-10-18 15:59:17 +03:00
Daniel Holbach ed1ac6877d update to new doc links structure
Signed-off-by: Daniel Holbach <daniel@weave.works>
2022-08-30 15:26:51 +02:00
Surya 0f0b2aaf13
Update docs/spec/v1beta2/kustomization.md
Co-authored-by: Max Jonas Werner <makkes@users.noreply.github.com>
Signed-off-by: Surya <surya.pandian@truelayer.com>
2022-08-24 10:46:31 +01:00
Surya 5d95817362
Update kustomization.md
Signed-off-by: Surya <surya.pandian@truelayer.com>
2022-08-20 21:57:22 +01:00
Surya 2a84f3d874
Update kustomization.md
Signed-off-by: Surya <surya.pandian@truelayer.com>
2022-08-20 17:02:04 +01:00
Stefan Prodan a7d790f1b2
Add support for OCIRepository sources
- allow `OCIRepository` to be specified in `sourceRef.kind`
- react to `OCIRepository` artifacts events
- add end-to-end test for OCI repositories

Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2022-08-08 18:26:03 +03:00
Andrés Botero 323c2d3253
Fix typo from pune to prune
Signed-off-by: Andrés Botero <yosoy@andresbotero.co>
2022-07-19 10:18:26 -05:00
Stefan Prodan a41274ff97
docs: Add example section and dockerconfigjson encryption
- remove the Go spec section
- add basic usage example
- fix SOPS CLI examples
- explain how to generate image pull secrets from encrypted dockerconfigjson files

Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2022-06-07 15:32:16 +03:00
Somtochi Onyekwere 2ac475ebef sops/gcpkms: add key source implementation
This adds a SOPS GCP KMS key source which makes use of the latest GCP
client, and supports both injection of master key credentials and a
default client making use of environmental runtime values.

The implementation fully replaces SOPS', and is covered with
compatability tests.

Signed-off-by: Somtochi Onyekwere <somtochionyekwere@gmail.com>
2022-05-24 21:51:46 +02:00
Sanskar Jaiswal d7307bbd51 add secret mount note in docs
Signed-off-by: Sanskar Jaiswal <sanskar.jaiswal@weave.works>
2022-05-20 14:43:21 +05:30
Sanskar Jaiswal 326e20c41b update code comments and kms decryption docs
Signed-off-by: Sanskar Jaiswal <sanskar.jaiswal@weave.works>
2022-05-19 14:34:16 +05:30
Sanskar Jaiswal c801f75458 add docs
Signed-off-by: Sanskar Jaiswal <sanskar.jaiswal@weave.works>
2022-05-19 14:33:31 +05:30
Hidde Beydals 2b2246c876 spec: take note of KubeConfig.SecretRef.Key field
Signed-off-by: Hidde Beydals <hello@hidde.co>
2022-05-03 15:59:04 +02:00
Stefan Prodan cafbe253a1
Disallow remote bases usage in Kustomize overlays
Add an optional flag for disabling remote bases. While the `--no-remote-bases` is set to `false` by default, Flux users are encouraged to enable it on production system for security and performance reasons. Using Kustomize remote bases means that kustomize-controller must clone the remote repositories on every reconciliation instead of using the source-controller artifacts cache. Allowing remote bases on multi-tenant clusters, means platform admins have no control over which repositories make up the desired state.

Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2022-04-27 14:54:43 +03:00
Sunny 1e616ed9e0
docs/spec/v1beta2: fix recommended settings typo
Signed-off-by: Sunny <darkowlzz@protonmail.com>
2022-04-01 08:22:11 +05:30
Stefan Prodan 8770770c1f
Add recommended settings to API docs
Add example of deploying applications from Git to production environments.

Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2022-03-29 11:30:10 +03:00
Hidde Beydals 9f768615a9 Document SOPS Azure Key Vault in spec
This includes a refactor of the other entries, to start moving guides
to the website while containing minimal technical (instructions)
in-spec.

Signed-off-by: Hidde Beydals <hello@hidde.co>
2022-03-14 10:29:02 +01:00
Stefan Prodan 608531e499
Merge pull request #582 from kingdonb/fixup-kubeval
fixup reference to kubeval
2022-03-07 14:44:04 +02:00
Kingdon Barrett 89841cbe28
fixup reference to kubeval
Update docs/spec/v1beta2/kustomization.md

Co-authored-by: Stefan Prodan <stefan.prodan@gmail.com>
Signed-off-by: Kingdon Barrett <kingdon@weave.works>
2022-03-07 07:27:26 -05:00
Stefan Prodan d56695a93b
Allow shared ownership of in-cluster objects applied with kubectl
Introduce an annotation that configures kustomize-controller to co-manage objects applied with kubectl.

Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2022-03-04 12:37:30 +02:00
Stefan Prodan 91f6d8e0a8
Release v0.21.1
Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2022-02-23 10:32:25 +02:00
Steven E. Harris af038d6df5
Copyedit Kustomization documentation
Signed-off-by: Steven E. Harris <seh@panix.com>
2022-02-15 09:27:45 -05:00
Steven E. Harris eba4168672
Tolerate absence of resources in post-build subst.
In a Kustomization's post-build substitution sources, introduce a new
"Optional" field to allow referencing a Kubernetes ConfigMap or Secret
that may not exist at time of reconciliation. Treat substitution when
the referenced object is missing as if the object had been present but
empty, lacking any variable bindings.

Retain the longstanding behavior of interpreting references to
Kubernetes objects being mandatory by default, such that
reconciliation fails if such a referenced object does not exist. Only
when the "Optional" field is set to true will reconciliation tolerate
finding the referenced object to be missing.

Signed-off-by: Steven E. Harris <seh@panix.com>
2022-02-15 09:27:41 -05:00
Kingdon Barrett 3d95b875e1
Clarify that spec.path is in the Kustomization
+ in the `spec.path` of the Flux `Kustomization`

In #2357 it was noted that we mention `spec.path` but the code example
provided for context is a `GitRepository`. This is a leap too far, let's
provide this to better clarify the context.

Signed-off-by: Kingdon Barrett <kingdon@weave.works>
2022-02-09 16:17:19 -05:00
Daniel Holbach d768b6cf76 fix typo
Signed-off-by: Daniel Holbach <daniel@weave.works>
2022-02-08 10:25:01 +01:00
Stefan Prodan 4d7cba91b0
Allow setting a default service account for impersonation
Introduce the flag `--default-service-account` for allowing cluster admins to enforce impersonation for resources reconciliation.

Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2022-01-27 18:25:02 +02:00
Stefan Prodan 518c8a021b
Allow disabling cross-namespace references
Introduce the flag `--no-cross-namespace-refs` (defaults to false) for allowing cluster admins to disable cross-namespace references to sources.

Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2022-01-26 22:50:10 +02:00
Soule BA c579e71430
add native support for sops decryption/encryption with Vault
If implemented, the kustomize controller will be able to retrieve a
secret containing a VAULT TOKEN and use it to decrypt the sops encrypted
master key. It will then use it to decrypt the data key and finally use the data
key to decrypt the final data.

Signed-off-by: Soule BA <bah.soule@gmail.com>
2022-01-19 21:59:10 +01:00
Gonzalo Villafañe Tapia 6c343e15ae Docs - Add var substitution operator escape syntax
Signed-off-by: Gonzalo Villafañe Tapia <gvillafanetapia@gmail.com>
2022-01-14 17:46:10 -03:00
George Gaál 2b32f0f7a3 Update kustomization.md
fix typo

Signed-off-by: Gaál George <gb12335@gmail.com>
2021-12-30 15:21:21 +01:00
Somtochi Onyekwere 6fa1c8a9dd Add docs for when KC doesn't revert
Signed-off-by: Somtochi Onyekwere <somtochionyekwere@gmail.com>
2021-12-02 10:41:20 +01:00
Somtochi Onyekwere 0d9bd5a554 Add line above yaml block
Signed-off-by: Somtochi Onyekwere <somtochionyekwere@gmail.com>
2021-11-29 12:02:45 +01:00
Somtochi Onyekwere f6403df16f Add test for varsub in secret
Signed-off-by: Somtochi Onyekwere <somtochionyekwere@gmail.com>
2021-11-25 12:34:20 +01:00
Stefan Prodan 0ce7c1267e
Allow disabling the reconciliation of in-cluster resources
Introduce `kustomize.toolkit.fluxcd.io/reconcile` annotation. When set to `disabled`, the controller will no longer apply changes from source, nor it will prune the annotated resource.

Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2021-11-09 10:50:52 +02:00
Stefan Prodan c610944139
SOPS: Fix dotenv decryption error reporting
Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2021-10-19 11:10:10 +03:00
Stefan Prodan 95dca0feb6
SOPS: Document env secret generator
Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2021-10-19 10:03:46 +03:00
Stefan Prodan dba56a569e
Add example for `.spec.wait` usage
Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2021-10-07 11:37:39 +03:00
Stefan Prodan 64084ea03b
Add test for reconciling an empty source
Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2021-09-30 18:35:40 +03:00
Stefan Prodan 9c8f284b7f
Add `spec.wait` usage to the API docs
Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2021-09-30 18:35:40 +03:00
Stefan Prodan 7ffe62b8e7
Introduce v1beta2 API
Changes from v1beta1:
- `spec.validation` removed (server-side validation is implicit)
- `spec.status.snapshot` replaced by `spec.status.inventory`
- `spec.patchesStrategicMerge` deprecated in favour of `spec.patches`
- `spec.patchesJson6902` deprecated in favour of `spec.patches`

Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2021-09-30 18:33:26 +03:00