diff --git a/content/master/get-started/install.md b/content/master/get-started/install.md index dbae7689..552ad27c 100644 --- a/content/master/get-started/install.md +++ b/content/master/get-started/install.md @@ -87,7 +87,7 @@ crossplane-rbac-manager-86d9b5cf9f-2vc4s 1/1 Running 0 26m Crossplane supports customizations at install time by configuring the Helm chart. -Read [the Helm chart README](https://github.com/crossplane/crossplane/blob/v2/cluster/charts/crossplane/README.md#configuration) +Read [the Helm chart README](https://github.com/crossplane/crossplane/blob/v2/cluster/charts/crossplane/README.md#configuration) to learn what customizations are available. Read [the Helm documentation](https://helm.sh/docs/) to learn how to run Helm @@ -103,25 +103,17 @@ at the table below. {{< expand "Feature flags" >}} {{< table caption="Feature flags" >}} -| Status | Flag | Description | -| --- | --- | --- | -| Beta | `--enable-deployment-runtime-configs` | Enable support for DeploymentRuntimeConfigs. | -| Beta | `--enable-usages` | Enable support for Usages. | -| Beta | `--enable-realtime-compositions` | Enable support for real time compositions. | -| Alpha | `--enable-dependency-version-upgrades ` | Enable automatic version upgrades of dependencies when updating packages. | -| Alpha | `--enable-function-response-cache` | Enable caching of composition function responses to improve performance. | -| Alpha | `--enable-signature-verification` | Enable support for package signature verification via ImageConfig API. | +| Status | Flag | Description | +|--------|-----------------------------------------|---------------------------------------------------------------------------| +| Beta | `--enable-deployment-runtime-configs` | Enable support for DeploymentRuntimeConfigs. | +| Beta | `--enable-usages` | Enable support for Usages. | +| Beta | `--enable-realtime-compositions` | Enable support for real time compositions. | +| Alpha | `--enable-dependency-version-upgrades ` | Enable automatic version upgrades of dependencies when updating packages. | +| Alpha | `--enable-function-response-cache` | Enable caching of composition function responses to improve performance. | +| Alpha | `--enable-signature-verification` | Enable support for package signature verification via ImageConfig API. | {{< /table >}} {{< /expand >}} Set these flags either in the `values.yaml` file or at install time using the `--set` flag, for example: `--set args='{"--enable-composition-functions","--enable-composition-webhook-schema-validation"}'`. - -#### Change the default package registry - -Beginning with Crossplane version 1.20.0 Crossplane uses the [crossplane-contrib](https://github.com/orgs/crossplane-contrib/packages) GitHub Container Registry at `xpkg.crossplane.io` by default for downloading and -installing packages. - -Change the default registry location during the Crossplane install with -`--set args='{"--registry=index.docker.io"}'`. diff --git a/content/master/guides/upgrade-crossplane.md b/content/master/guides/upgrade-crossplane.md index 7aee892d..33be43c1 100644 --- a/content/master/guides/upgrade-crossplane.md +++ b/content/master/guides/upgrade-crossplane.md @@ -9,7 +9,7 @@ The recommended upgrade method for an existing Crossplane install is to use ## Prerequisites * [Helm](https://helm.sh/docs/intro/install/) version `v3.2.0` or later - + ## Add the Crossplane Helm repository Verify Helm has the Crossplane repository. @@ -27,35 +27,26 @@ helm repo update ``` {{}} -Upgrading Crossplane without updating the Helm chart installs the last version +Upgrading Crossplane without updating the Helm chart installs the last version available in the locally cached Helm chart. {{< /hint >}} ## Upgrade Crossplane -Upgrade Crossplane with `helm upgrade`, providing the Crossplane namespace. +Upgrade Crossplane with `helm upgrade`, providing the Crossplane namespace. By default, Crossplane installs into the `crossplane-system` -namespace. +namespace. ```shell helm upgrade crossplane --namespace crossplane-system crossplane-stable/crossplane ``` Helm preserves any arguments or flags originally used when installing -Crossplane. +Crossplane. Crossplane uses any new default behaviors unless they're changed in the `helm upgrade` command. -For example, in v1.20.0 Crossplane changed the default image registry from -`index.docker.io` to `xpkg.crossplane.io`. Upgrading Crossplane from a version -before v1.20.0 updates the default package registry. - -Override new defaults by -[customizing the Helm chart]({{}}) +Override new defaults by +[customizing the Helm chart]({{}}) with the upgrade command. - -For example, to maintain the original image registry use -```shell -helm upgrade crossplane --namespace crossplane-system crossplane-stable/crossplane --set 'args={"--registry=index.docker.io"}' -``` diff --git a/content/v2.0/get-started/install.md b/content/v2.0/get-started/install.md index dbae7689..552ad27c 100644 --- a/content/v2.0/get-started/install.md +++ b/content/v2.0/get-started/install.md @@ -87,7 +87,7 @@ crossplane-rbac-manager-86d9b5cf9f-2vc4s 1/1 Running 0 26m Crossplane supports customizations at install time by configuring the Helm chart. -Read [the Helm chart README](https://github.com/crossplane/crossplane/blob/v2/cluster/charts/crossplane/README.md#configuration) +Read [the Helm chart README](https://github.com/crossplane/crossplane/blob/v2/cluster/charts/crossplane/README.md#configuration) to learn what customizations are available. Read [the Helm documentation](https://helm.sh/docs/) to learn how to run Helm @@ -103,25 +103,17 @@ at the table below. {{< expand "Feature flags" >}} {{< table caption="Feature flags" >}} -| Status | Flag | Description | -| --- | --- | --- | -| Beta | `--enable-deployment-runtime-configs` | Enable support for DeploymentRuntimeConfigs. | -| Beta | `--enable-usages` | Enable support for Usages. | -| Beta | `--enable-realtime-compositions` | Enable support for real time compositions. | -| Alpha | `--enable-dependency-version-upgrades ` | Enable automatic version upgrades of dependencies when updating packages. | -| Alpha | `--enable-function-response-cache` | Enable caching of composition function responses to improve performance. | -| Alpha | `--enable-signature-verification` | Enable support for package signature verification via ImageConfig API. | +| Status | Flag | Description | +|--------|-----------------------------------------|---------------------------------------------------------------------------| +| Beta | `--enable-deployment-runtime-configs` | Enable support for DeploymentRuntimeConfigs. | +| Beta | `--enable-usages` | Enable support for Usages. | +| Beta | `--enable-realtime-compositions` | Enable support for real time compositions. | +| Alpha | `--enable-dependency-version-upgrades ` | Enable automatic version upgrades of dependencies when updating packages. | +| Alpha | `--enable-function-response-cache` | Enable caching of composition function responses to improve performance. | +| Alpha | `--enable-signature-verification` | Enable support for package signature verification via ImageConfig API. | {{< /table >}} {{< /expand >}} Set these flags either in the `values.yaml` file or at install time using the `--set` flag, for example: `--set args='{"--enable-composition-functions","--enable-composition-webhook-schema-validation"}'`. - -#### Change the default package registry - -Beginning with Crossplane version 1.20.0 Crossplane uses the [crossplane-contrib](https://github.com/orgs/crossplane-contrib/packages) GitHub Container Registry at `xpkg.crossplane.io` by default for downloading and -installing packages. - -Change the default registry location during the Crossplane install with -`--set args='{"--registry=index.docker.io"}'`. diff --git a/content/v2.0/guides/upgrade-crossplane.md b/content/v2.0/guides/upgrade-crossplane.md index 7aee892d..33be43c1 100644 --- a/content/v2.0/guides/upgrade-crossplane.md +++ b/content/v2.0/guides/upgrade-crossplane.md @@ -9,7 +9,7 @@ The recommended upgrade method for an existing Crossplane install is to use ## Prerequisites * [Helm](https://helm.sh/docs/intro/install/) version `v3.2.0` or later - + ## Add the Crossplane Helm repository Verify Helm has the Crossplane repository. @@ -27,35 +27,26 @@ helm repo update ``` {{}} -Upgrading Crossplane without updating the Helm chart installs the last version +Upgrading Crossplane without updating the Helm chart installs the last version available in the locally cached Helm chart. {{< /hint >}} ## Upgrade Crossplane -Upgrade Crossplane with `helm upgrade`, providing the Crossplane namespace. +Upgrade Crossplane with `helm upgrade`, providing the Crossplane namespace. By default, Crossplane installs into the `crossplane-system` -namespace. +namespace. ```shell helm upgrade crossplane --namespace crossplane-system crossplane-stable/crossplane ``` Helm preserves any arguments or flags originally used when installing -Crossplane. +Crossplane. Crossplane uses any new default behaviors unless they're changed in the `helm upgrade` command. -For example, in v1.20.0 Crossplane changed the default image registry from -`index.docker.io` to `xpkg.crossplane.io`. Upgrading Crossplane from a version -before v1.20.0 updates the default package registry. - -Override new defaults by -[customizing the Helm chart]({{}}) +Override new defaults by +[customizing the Helm chart]({{}}) with the upgrade command. - -For example, to maintain the original image registry use -```shell -helm upgrade crossplane --namespace crossplane-system crossplane-stable/crossplane --set 'args={"--registry=index.docker.io"}' -```