Installing Crossplane with Yandex Cloud support

Crossplane is a freeware add-on to Kubernetes that enables platform development teams to build infrastructure for multiple vendors and produce higher-level service APIs for application development teams.

Getting startedGetting started

1. If you do not have the Yandex Cloud command line interface yet, install and initialize it.

   The folder specified in the CLI profile is used by default. You can specify a different folder using the --folder-name or --folder-id parameter.

2. Create a service account with the admin role. It is required for Crossplane to run.

3. Create a service account key and save it to the file:

   yc iam key create --service-account-name <service_account_name> --output key.json
   

4. Make sure that the security groups for the Managed Service for Kubernetes cluster and its node groups are configured correctly. If any rule is missing, add it.

   Warning

   The configuration of security groups determines the performance and availability of the cluster and the services and applications running in it.

Installation using Yandex Cloud MarketplaceInstallation using Yandex Cloud Marketplace

1. Go to the folder page and select Managed Service for Kubernetes.
2. Click the name of the Managed Service for Kubernetes cluster you need and select the Marketplace tab.
3. Under Application available for installation, select Crossplane with Yandex Cloud support and click Go to install.
4. Configure the application:
   • Namespace: Select a namespace for Crossplane or create a new one.
   • Application name: Specify the app name.
   • Service account key: Paste the contents of the service account key file you previously obtained, or create a new one.
5. Click Install.
6. Wait for the application to change its status to Deployed.

Installation using a Helm chartInstallation using a Helm chart

1. Install Helm v3.8.0 or higher.

2. Install kubectl and configure it to work with the created cluster.

3. To install a Helm chart with Crossplane, run the following command:

   helm pull oci://cr.yandex/yc-marketplace/yandex-cloud/crossplane/crossplane \
     --version 1.14.8 \
     --untar && \
   helm install \
     --namespace <namespace> \
     --create-namespace \
     --set-file providerJetYC.creds=key.json \
     crossplane ./crossplane/
   

   Note

   If you are using a Helm version below 3.8.0, append the export HELM_EXPERIMENTAL_OCI=1 && \ string to the command to enable Open Container Initiative (OCI) support in the Helm client.

Installation using the Helm GitHub repositoryInstallation using the Helm GitHub repository

1. Install Helm v3.8.0 or higher.

2. Install kubectl and configure it to work with the created cluster.

3. Create a namespace for Crossplane:

   kubectl create namespace <namespace>
   

4. Add the Helm GitHub repository:

   helm repo add crossplane-stable https://charts.crossplane.io/stable && \
   helm repo update
   

5. Install Crossplane:

   helm install crossplane --namespace crossplane-system crossplane-stable/crossplane
   

6. Make sure that Crossplane is installed and running:

   helm list -n crossplane-system && \
   kubectl get all -n crossplane-system
   

7. Install the Crossplane CLI:

   curl -sL https://raw.githubusercontent.com/crossplane/crossplane/master/install.sh | sh && \
   sudo mv kubectl-crossplane $(dirname $(which kubectl))
   

8. Install the provider:

   kubectl crossplane install provider xpkg.upbound.io/yandexcloud/crossplane-provider-yc:v0.4.1
   

   The current provider version is available in the GitHub repository.

Use casesUse cases

• Integration with Crossplane

See alsoSee also

• Crossplane documentation