Provider Yandex Cloud (shturval-capy)

About the service

ParameterDescription
GUI nameYandex Cloud Provider
System name (identifier)shturval-capy
Cluster AssignmentIntegration with Yandex Cloud: deployment of virtual machines for cluster nodes via the Cluster API. Installed in the management cluster.
CriticalNo
Public repositoryCluster API Provider Yandex Cloud
Dependenciesshturval-capy-crds, shturval-capi-crds
Namespacecapy-system

Purpose

shturval-capy is the Yandex Cloud provider for the Cluster API. Provides creation and management of virtual machines in Yandex Cloud for use as nodes of Kubernetes clusters.

Installing the service

shturval-capy - infrastructure provider Cluster API for Yandex Cloud. In the Shturval platform, the connection and life cycle of such a provider in the management cluster is ensured by cluster-manager; ShturvalServiceConfig (SSC) objects for provider charts are created and maintained as part of the platform configuration, rather than as an arbitrary manual installation of a service chart.

In the production environment, the provider is represented by two SSCs:

  • shturval-capy — main chart of the Yandex Cloud provider;
  • shturval-capy-crds — CRD chart of the Yandex Cloud provider module.

For correct operation, the CRD of the main Cluster API (shturval-capi-crds and the associated component shturval-capi) must be available in the management cluster.

If the service was disabled during platform deployment, the provider’s SSCs could receive an absence mode (mode: absent). To make the provider available to work with the cloud, first switch the shturval-capy-crds mode to auto, then shturval-capy to auto. You can change the mode in the platform GUI on the Providers page.

In the GUI, this action is performed by the service mode switch. The screenshot shows the selection of the Auto mode for the provider service.

Switching provider service mode

Customvalues parameters

The structure of the main chart values is described by the spec.customvalues field of the corresponding ShturvalServiceConfig and coincides with the helm/main/values.yaml of the shturval-capy chart.

Recommendation: do not edit the ShturvalServiceConfig object manually to change limits, nodeSelector, cloud connection parameters and other release settings - such an object belongs to the platform configuration and can be overwritten during updates. Make all changes to the behavior of the service through ShturvalServicePatch (SSP), which overlays spec.customvalues on top of the base SSC.

Where to configure

Services and repositories → Installed services → shturval-capy → Manage. The service is hosted in the management cluster.

Configuring provider instances in the platform - Yandex Cloud. General overview - How work with providers in the platform works.

Persistent volumes for Yandex Cloud clusters are provided by shturval-capy-csi. It is installed when the provider instance allows CSI and CSI integration is enabled during cluster creation.

For reference: For Yandex Cloud infrastructure CR, see section Custom node life cycle resources - Yandex Cloud.