Etape 1 : Libération d'adresses IP individuelles

Commencez par rechercher et libérer des adresses IP individuelles qui n'ont pas été correctement supprimées dans les enregistrements IPAM de Calico afin de permettre leur réutilisation par les pods de votre cluster.

1. Procédez comme indiqué dans la rubrique Installation et configuration de l'interface de ligne de commande de Calico pour télécharger la version 3.18 ou une version ultérieure du client calicoctl, utilisez la configuration Calico appropriée pour votre cluster et vérifiez que celle-ci fonctionne correctement pour votre cluster cible. Notez que même si votre cluster utilise une ancienne version d' Calico, vous pouvez tout de même utiliser la version 3.18 d' calicoctl pour exécuter les commandes décrites dans les étapes suivantes.

2. Recherchez les adresses IP détectées par erreur comme étant utilisées par le gestionnaire IPAM de Calico.

   calicoctl ipam check
   

3. Dans la sortie, recherchez la section contenant la ligne Scanning for IPs that are allocated but not actually in use.... Si des adresses IP sont allouées dans IPAM mais ne sont pas réellement utilisées, passez à l'étape suivante pour les libérer. Dans cet exemple de sortie, 181 adresses IP peuvent être libérées.

   ...
   Scanning for IPs that are allocated but not actually in use...
   Found 181 IPs that are allocated in IPAM but not actually in use.
   Scanning for IPs that are in use by a workload or node but not allocated in IPAM...
   Found 0 in-use IPs that are not in active IP pools.
   Found 0 in-use IPs that are in active IP pools but have no corresponding IPAM allocation.
   Check complete; found 181 problems.
   

4. Libérez les adresses IP du gestionnaire IPAM de Calico qui étaient précédemment affectées à un noeud final de pod. Notez qu'une fois que vous avez verrouillé le magasin de données dans les étapes suivantes, les pods existants continuent à s'exécuter, mais tous les pods créés restent à l'état ContainerCreating et ne peuvent pas démarrer tant que vous n'avez pas déverrouillé le magasin de données. Ce verrouillage de magasin de données garantit que les enregistrements IPAM ne sont pas modifiés pendant la libération des adresses IP. Pour plus d'informations, consultez la documentation open source d' Calico.

   1. Verrouillez le magasin de données pour les enregistrements IPAM de Calico.

       calicoctl datastore migrate lock
       ```
   2. Sauvegardez les résultats de la vérification IPAM.
   ```sh {: pre}
       calicoctl ipam check -o report.json
       ```
   3. Libérez les adresses IP inutilisées. Ce processus peut durer jusqu'à 20 minutes en fonction du nombre d'adresses IP à libérer.
   ```sh {: pre}
       calicoctl ipam release --from-report=report.json
       ```
   4. Déverrouillez le magasin de données.
   ```sh {: pre}
       calicoctl datastore migrate unlock
       ```
   5. Vérifiez que toutes les adresses IP inutilisées sont libérées.
   ```sh {: pre}
       calicoctl ipam check
       ```
       Exemple de sortie
   
       ```sh {: screen}
       Check complete; found 0 problems.
       ```
   

5. Facultatif : pour vérifier que le magasin de données a été correctement déverrouillé et que des adresses IP sont désormais disponibles pour affectation, créez un pod et vérifiez qu'il démarre correctement.

   1. Par exemple, créez un pod NGINX simple.

       oc run test --image=nginx --generator=run-pod/v1
       ```
   2. Vérifiez que le pod possède une adresse IP et qu'il fonctionne correctement.
   ```sh {: pre}
       oc get po test
       ```
   3. Supprimez le pod de test.
   ```sh {: pre}
       oc delete pod test
       ```
   

6. Passez à la section suivante pour rechercher les blocs d'adresses IP inutilisés.

Etape 2 : Libération de blocs d'adresses IP

A présent, recherchez et supprimez les blocs entiers d'adresses IP qui étaient affectés à un noeud worker mais que celui-ci n'utilise plus.

Il peut arriver que lorsqu'un deuxième ou un troisième bloc d'adresses IP est affecté à un noeud worker, des blocs entiers d'adresses IP que celui-ci utilisait précédemment ne soient plus utilisés. De plus, lorsque vous retirez ou remplacez un noeud worker, le nettoyage du bloc d'adresses IP par le gestionnaire IPAM de Calico peut échouer car il n'existe aucun noeud worker sur lequel exécuter calico-kube-controllers temporairement ou il existe des problèmes liés au plug-in CNI ou au module d'exécution containerd lors du retrait ou du remplacement du noeud worker.

Il est essentiel de s'assurer que des blocs d'adresses IP sont libres pour tous les clusters classiques qui exécutent Kubernetes version 1.19 ou une version ultérieure et pour tous les clusters VPC. Dans ces clusters, le paramètre Calico strictAffinity a pour valeur true, ce qui force un noeud worker à utiliser uniquement les adresses IP issues de ses blocs d'adresses IP au lieu d'utiliser les adresses IP issues de blocs qui sont affectés à d'autres noeuds worker. Avec le temps, les blocs qui sont affectés à des noeuds mais qui ne sont pas utilisés peuvent s'accumuler, en empêchant à terme l'affectation de blocs d'adresses IP aux noeuds worker.

1. Procédez comme suit pour libérer des adresses IP individuelles :

2. Choisissez de verrouiller le magasin de données pour les enregistrements IPAM de Calico.

   • Si vous verrouillez le magasin de données, les pods existants continuent à s'exécuter, mais tous les pods créés restent à l'état ContainerCreating et ne peuvent pas démarrer tant que vous n'avez pas déverrouillé le magasin de données. Ce verrou de magasin de données garantit que les pods ne peuvent pas être créées une fois que vous avez vérifié les blocs non utilisés, mais avant de libérer les blocs.
   • Si vous ne verrouillez pas le magasin de données, vous devez immédiatement vérifier qu'aucun nouveau pod n'a utilisé les adresses IP d'un bloc libéré que vous avez supprimé.

   calicoctl datastore migrate lock
   

3. Répertoriez les enregistrements IPAM de Calico. Dans la sortie, recherchez les blocs pour lesquels le paramètre IPS IN USE a pour valeur 0. Cela signifie que ces blocs ne sont pas utilisés par les noeuds worker qui leur sont affectés.

   calicoctl ipam show --show-blocks
   

   Dans cet exemple de sortie, aucune adresse IP du bloc 172.24.10.64/26 n'est utilisée.

   ...
   Block    | 172.24.10.64/26  |        64 | 0 (0%)     | 64 (100%)  |
   ...
   

4. Procédez comme suit pour libérer chacun des blocs :

   1. Vérifiez qu'aucun pod n'utilise une adresse IP issue du bloc.

       oc get pods -A
       ```
   2. Obtenez le `BlockAffinity` pour le bloc. Remplacez les périodes et la barre oblique dans le bloc par des traits d'union (-). Par exemple, pour le bloc `172.24.10.64/26`, le format de la commande suivante est `172-24-10-64-26`.
   ```sh {: pre}
       oc get blockaffinity | grep <block>
       ```
   3. Supprimez le `BlockAffinity`.
   ```sh {: pre}
       oc delete blockaffinity <block_affinity>
       ```
   4. Obtenez le `IPAMBlock` pour le bloc. Remplacez les périodes et la barre oblique dans le bloc par des traits d'union (-). Par exemple, pour le bloc `172.24.10.64/26`, le format de la commande suivante est `172-24-10-64-26`.
   ```sh {: pre}
       oc get ipamblock | grep <block>
       ```
   5. Supprimez le `IPAMBlock`.
   ```sh {: pre}
       oc delete ipamblock <ipam_block>
       ```
   6. Si vous n'avez pas verrouillé le magasin de données à l'étape 2, vérifiez qu'aucun pod n'a été créé directement avant la suppression du `BlockAffinity` et de l'`IPAMBlock`. Si des pods ont été créés, vous devez supprimer à nouveau le `BlockAffinity` et l'`IPAMBlock` pour ce bloc. Ensuite, supprimez les pods qui utilisent une adresse IP dans ce bloc en exécutant `oc delete pod <pod>` afin que le pod soit recréé avec une adresse IP d'un bloc différent.
   ```sh {: pre}
       oc get pods -A
       ```
   7. Répétez ces étapes pour tous les autres blocs dont la valeur « `IPS IN USE` » est égale à 0.
   
   

5. Si vous avez verrouillé le magasin de données à l'étape 2, déverrouillez-le.

   calicoctl datastore migrate unlock