Créer des clusters autonomes

Cette page explique comment créer un cluster autonome, qui est un cluster autogéré exécutant des charges de travail. Les clusters autonomes ne gèrent pas d'autres clusters, ce qui élimine le besoin d'exécuter un cluster d'administrateur distinct dans les scénarios à ressources limitées. De plus, les clusters autonomes offrent deux profils d'installation au choix :

Par défaut : le profil par défaut a des besoins en ressources limités.
Périphérie : le profil de périphérie a considérablement réduit les besoins en ressources système. Il est recommandé pour les appareils de périphérie ayant de grosses contraintes en matière de ressources.

Avant de créer un cluster autonome, tenez compte du compromis entre réduction des ressources et sécurité globale. Étant donné que les clusters autonomes se gèrent eux-mêmes, l'exécution de charges de travail sur le même cluster augmente le risque d'exposition de données administratives sensibles, telles que les clés SSH.

Prérequis

Avant de pouvoir créer un cluster autonome, vérifiez les points suivants :

La dernière version de bmctl est téléchargée (gs://anthos-baremetal-release/bmctl/1.12.9/linux-amd64/bmctl) à partir de Cloud Storage.
Le poste de travail qui exécute bmctl dispose d'une connectivité réseau à tous les nœuds du cluster autonome cible.
Le poste de travail qui exécute bmctl dispose d'une connectivité réseau à l'adresse IP virtuelle du plan de contrôle du cluster autonome cible.
La clé SSH utilisée pour créer le cluster autonome est disponible depuis la racine, ou l'utilisateur dispose d'un accès SUDO à tous les nœuds du cluster autonome cible.
Le compte de service "connect-register" est configuré pour une utilisation avec Connect.

Activer SELinux

Si vous souhaitez activer SELinux pour sécuriser vos conteneurs, vous devez vous assurer que SELinux est activé en mode Enforced sur toutes vos machines hôtes. À partir de la version 1.9.0 des clusters Anthos sur solution Bare Metal, vous pouvez activer ou désactiver SELinux avant ou après la création des clusters, ou leurs mises à niveau. SELinux est activé par défaut sur Red Hat Enterprise Linux (RHEL) et CentOS. Si SELinux est désactivé sur vos machines hôtes ou si vous n'êtes pas sûr, consultez la section Sécuriser vos conteneurs à l'aide de SELinux pour savoir comment l'activer.

Les clusters Anthos sur solution Bare Metal ne sont compatibles avec SELinux que dans les systèmes RHEL et CentOS.

Créer un cluster autonome

Vous pouvez créer un cluster autonome doté d'un seul plan de nœud de contrôle à l'aide de la commande bmctl. Ce type de configuration réduit la consommation de ressources, mais ne fournit pas de haute disponibilité. Le cluster résultant présente un seul point de défaillance.

Vous pouvez également créer un cluster autonome à haute disponibilité. En mode haute disponibilité, si un nœud échoue, d'autres remplaceront. Pour créer un cluster autonome à haute disponibilité, vous devez spécifier au moins trois nœuds pour le plan de contrôle.

La commande bmctl peut généralement être exécutée sur un poste de travail distinct ou sur l'un des nœuds du cluster autonomes. Toutefois, si vous créez un cluster autonome avec le profil de périphérie activé et que les ressources minimales requises sont configurées, nous vous recommandons d'exécuter bmctl sur un poste de travail distinct.

Se connecter à `gcloud`

Connectez-vous à gcloud en tant qu'utilisateur :
```
gcloud auth application-default login
```
Vous devez disposer d'un rôle de propriétaire/éditeur de projet pour utiliser les fonctionnalités d'activation automatique d'API et de création de compte de service décrites ci-dessous.

Vous pouvez également ajouter les rôles IAM suivants à l'utilisateur :
- Administrateur de compte de service
- Administrateur de clés de compte de service
- Administrateur de projet IAM
- Lecteur de Compute
- Administrateur Service Usage
Si vous disposez déjà d'un compte de service avec ces rôles, exécutez la commande suivante :
```
export GOOGLE_APPLICATION_CREDENTIALS=JSON_KEY_FILE
```
Remplacez JSON_KEY_FILE par le chemin d'accès au fichier de clé JSON de votre compte de service.
Obtenez l'ID du projet Cloud à utiliser avec la création de cluster :
```
export CLOUD_PROJECT_ID=$(gcloud config get-value project)
```

Créer un fichier de configuration de cluster autonome

Une fois que vous vous êtes connecté à gcloud et que votre projet est configuré, vous pouvez créer le fichier de configuration de cluster à l'aide de la commande bmctl. Dans cet exemple, tous les comptes de service sont automatiquement créés par la commande bmctl create config :

bmctl create config -c STANDALONE_CLUSTER_NAME --enable-apis \
    --create-service-accounts --project-id=$CLOUD_PROJECT_ID

Remplacez les éléments suivants :

STANDALONE_CLUSTER_NAME par le nom du cluster autonome que vous souhaitez créer.

Exemple

La commande suivante crée un fichier de configuration pour un cluster autonome appelé standalone1 associé à l'ID de projet my-gcp-project :

bmctl create config -c standalone1 --create-service-accounts --project-id=my-gcp-project

Le fichier est écrit dans bmctl-workspace/standalone1/standalone1.yaml.

Au lieu d'activer des API et de créer des comptes de service automatiquement, vous pouvez également fournir à vos comptes de service existants les autorisations IAM appropriées, si vous les avez. Vous pouvez ainsi ignorer la création automatique de compte de service décrite à l'étape précédente dans la commande bmctl :

bmctl create config -c standalone1

Modifier le fichier de configuration de cluster

Maintenant que vous disposez d'un fichier de configuration de cluster, modifiez-le comme suit :

Ajoutez la clé privée SSH pour accéder aux nœuds du cluster autonome :

# bmctl configuration variables. Because this section is valid YAML but not a valid Kubernetes
# resource, this section can only be included when using bmctl to
# create the initial admin/hybrid cluster. Afterwards, when creating user clusters by directly
# applying the cluster and node pool resources to the existing cluster, you must remove this
# section.
gcrKeyPath: bmctl-workspace/.sa-keys/my-gcp-project-anthos-baremetal-gcr.json
sshPrivateKeyPath: /path/to/your/ssh_private_key
gkeConnectAgentServiceAccountKeyPath: bmctl-workspace/.sa-keys/my-gcp-project-anthos-baremetal-connect.json
gkeConnectRegisterServiceAccountKeyPath: bmctl-workspace/.sa-keys/my-gcp-project-anthos-baremetal-register.json
cloudOperationsServiceAccountKeyPath: bmctl-workspace/.sa-keys/my-gcp-project-anthos-baremetal-cloud-ops.json

Enregistrez vos clusters dans un parc. L'ID de projet que vous avez spécifié dans la commande bmctl create config est automatiquement ajouté au champ gkeConnect.projectID dans le fichier de configuration du cluster. Ce projet est appelé projet hôte du parc.
- Si vous avez créé votre fichier de configuration à l'aide des fonctionnalités d'activation automatique des API et de création de compte de service, vous pouvez ignorer cette étape.
- Si vous avez créé le fichier de configuration sans utiliser les fonctionnalités d'activation automatique des API et de création de compte de service, faites référence aux clés JSON du compte de service téléchargées dans les champs gkeConnectAgentServiceAccountKeyPath et gkeConnectRegisterServiceAccountKeyPath correspondants du fichier de configuration de cluster.

Modifiez la configuration pour spécifier le type de cluster standalone au lieu de admin : Si vous souhaitez activer le profil de périphérie pour minimiser la consommation de ressources, spécifiez profile: edge :

spec:
  # Cluster type. This can be:
  #   1) admin:  to create an admin cluster. This can later be used to create user clusters.
  #   2) user:   to create a user cluster. Requires an existing admin cluster.
  #   3) hybrid: to create a hybrid cluster that runs admin cluster components and user workloads.
  #   4) standalone: to create a cluster that manages itself, runs user workloads, but does not manage other clusters.
  type: standalone
  # Edge profile minimizes the resource consumption of Anthos clusters on bare metal. It is only available for standalone clusters.
  profile: edge

(Facultatif) Modifiez la configuration pour spécifier un plan de contrôle à disponibilité élevée contenant plusieurs nœuds. Spécifiez un nombre impair de nœuds pour disposer d'un quorum majoritaire pour la haute disponibilité :
```
  # Control plane configuration
  controlPlane:
    nodePoolSpec:
      nodes:
      # Control plane node pools. Typically, this is either a single machine
      # or 3 machines if using a high availability deployment.
      - address: 10.200.0.4
      - address: 10.200.0.5
      - address: 10.200.0.6
```
Si vous disposez temporairement d'un nombre pair de nœuds pendant l'ajout ou la suppression de nœuds à des fins de maintenance ou de remplacement, votre déploiement maintient une haute disponibilité tant que vous avez assez de quorum.
Spécifiez la densité du pod des nœuds de cluster et l'environnement d'exécution du conteneur :
```
....
# NodeConfig specifies the configuration that applies to all nodes in the cluster.
nodeConfig:
  # podDensity specifies the pod density configuration.
  podDensity:
    # maxPodsPerNode specifies at most how many pods can be run on a single node.
    maxPodsPerNode: 250
  # containerRuntime specifies which container runtime to use for scheduling containers on nodes.
  # containerd and docker are supported.
  containerRuntime: containerd
....
```
Pour les clusters autonomes, les valeurs autorisées pour maxPodsPerNode sont 32-250 pour les clusters haute disponibilité et 64-250 pour les clusters non haute disponibilité. La valeur par défaut est 110 si elle n'est pas spécifiée. Une fois le cluster créé, cette valeur ne peut pas être mise à jour.

La densité des pods est également limitée par les ressources IP disponibles de votre cluster. Pour plus de détails, consultez la section Mise en réseau de pods.

L'environnement d'exécution du conteneur par défaut est containerd. Vous pouvez également utiliser Docker. Pour en savoir plus sur la modification de votre environnement d'exécution, consultez notre guide de modification de l'environnement d'exécution des conteneurs. Si vous activez le profil Edge avec la configuration minimale de ressources requise, nous vous recommandons d'utiliser containerd.

Créer le cluster autonome avec la configuration du cluster

Utilisez la commande bmctl pour déployer le cluster autonome :

bmctl create cluster -c CLUSTER_NAME

Remplacez CLUSTER_NAME par le nom du cluster que vous avez créé à l'étape précédente.

Vous trouverez ci-dessous un exemple de la commande permettant de créer un cluster appelé standalone1 :

bmctl create cluster -c standalone1

Exemples de configurations de cluster autonome

Pour obtenir des exemples de configurations de cluster autonome, consultez la section Clusters autonomes dans les exemples de configurations de cluster.