Utilitaires de stockage IBM Cloud
Classique : Installation du plug-in IBM Cloud Block Storage Attacher (bêta)
Utilisez le plug-in IBM Cloud Block Storage Attacher pour attacher des blocs de stockage bruts, non formatés et non montés à un nœud de travailleur classique dans votre cluster.
Le plug-in IBM Cloud Block Storage Attacher est disponible uniquement pour les noeuds worker classiques. Si vous souhaitez attacher un stockage en bloc brut et non formaté à un nœud de travailleur VPC, consultez la section Ajout de nœuds de travailleur Block Storage for VPC bruts.
Par exemple, vous souhaitez stocker vos données avec une solution de stockage (SDS) définie par le logiciel, telle que Portworx, mais vous ne souhaitez pas utiliser de nœuds worker bare metal lassiques qui sont optimisés pour l'utilisation de SDS et qui sont founris avec des disques locaux supplémentaires. Pour ajouter des disques locaux à votre noeud worker non SDS classique, vous devez créer manuellement vos unités de stockage par blocs dans votre compte d'infrastructure IBM Cloud et utiliser le plug-in IBM Cloud Block Volume Attacher pour connecter le stockage à votre noeud worker non SDS.
Le plug-in IBM Cloud Block Volume Attacher crée des pods sur tous les noeuds worker au sein d'un ensemble de démons (daemonSet) et configure une classe de stockage Kubernetes que vous pouvez utiliser par la suite pour connecter l'unité de stockage par blocs à votre noeud worker non SDS.
Vous recherchez des instructions pour mettre à jour ou supprimer le plug-in IBM Cloud Block Volume Attacher ? Voir Mise à jour du plug-in et Retrait du plug-in.
-
Suivez les instructions d'installation du client Helm version 3 sur votre machine locale.
-
Mettez à jour le référentiel Helm pour extraire la dernière version de toutes les chartes Helm figurant dans ce référentiel.
helm repo update
-
Installez le plug-in IBM Cloud Block Volume Attacher. Lors de l'installation de ce plug-in, des classes de stockage par blocs prédéfinies sont ajoutées dans votre cluster.
helm install block-attacher iks-charts/ibm-block-storage-attacher --namespace kube-system
Exemple de sortie
NAME: block-volume-attacher LAST DEPLOYED: Thu Sep 13 22:48:18 2018 NAMESPACE: default STATUS: DEPLOYED RESOURCES: ==> v1beta1/ClusterRoleBinding NAME AGE ibmcloud-block-storage-attacher 1s ==> v1beta1/DaemonSet NAME DESIRED CURRENT READY UP-TO-DATE AVAILABLE NODE SELECTOR AGE ibmcloud-block-storage-attacher 0 0 0 0 0 <none> 1s ==> v1/StorageClass NAME PROVISIONER AGE ibmc-block-attacher ibm.io/ibmc-blockattacher 1s ==> v1/ServiceAccount NAME SECRETS AGE ibmcloud-block-storage-attacher 1 1s ==> v1beta1/ClusterRole NAME AGE ibmcloud-block-storage-attacher 1s NOTES: Thank you for installing: ibmcloud-block-storage-attacher. Your release is named: block-volume-attacher Please refer Chart README.md file for attaching a block storage Please refer Chart RELEASE.md to see the release details/fixes
-
Vérifiez que l'ensemble de démons d'IBM Cloud Block Volume Attacher est installé.
oc get pod -n kube-system -o wide | grep attacher
Exemple de sortie
ibmcloud-block-storage-attacher-z7cv6 1/1 Running 0 19m
L'installation a abouti lorsque vous voyez un ou plusieurs pods ibmcloud-block-storage-attacher. Le nombre de pods est égal au nombre de noeuds worker dans votre cluster. Tous les pods doivent être à l'état Running.
-
Vérifiez que la classe de stockage d'IBM Cloud Block Volume Attacher a été créée.
oc get sc | grep attacher
Exemple de sortie
ibmc-block-attacher ibm.io/ibmc-blockattacher 11m
Mise à jour du plug-in IBM Cloud Block Storage Attacher
Vous pouvez mettre à niveau votre plug-in IBM Cloud Block Storage Attacher pour passer à la version la plus récente.
-
Mettez à jour le référentiel Helm pour extraire la dernière version de toutes les chartes Helm figurant dans ce référentiel.
helm repo update
-
Facultatif : téléchargez la charte Helm la plus récente sur votre machine locale. Ensuite, extrayez le package et consultez le fichier
release.md
pour trouver les informations relatives à la dernière édition.helm pull iks-charts/ibmcloud-block-storage-plugin
-
Recherchez le nom de la charte Helm correspondant au plug-in IBM Cloud Block Storage Attacher.
helm ls -A
Exemple de sortie
<helm_chart_name> 1 Wed Aug 1 14:55:15 2022 DEPLOYED ibm-block-storage-attacher-1.0.0 default
-
Mettez à niveau le plug-in IBM Cloud Block Storage Attacher à la dernière version.
helm upgrade --force --recreate-pods <helm_chart_name> ibm-block-storage-attacher
Retrait du plug-in IBM Cloud Block Volume Attacher
Si vous ne souhaitez pas fournir et utiliser le plug-in IBM Cloud Block Storage Attacher dans votre cluster, vous pouvez désinstaller le graphique Helm.
-
Recherchez le nom de la charte Helm correspondant au plug-in IBM Cloud Block Storage Attacher.
helm list | grep ibm-block-storage-attacher
Exemple de sortie
<helm_chart_name> 1 Wed Aug 1 14:55:15 2022 DEPLOYED ibm-block-storage-attacher-1.0.0 default
-
Supprimez le plug-in IBM Cloud Block Storage Attacher en retirant la charte Helm.
helm uninstall <helm_chart_name> -n <namespace>
-
Vérifiez que les pods du plug-in IBM Cloud Block Storage Attacher sont bien retirés.
oc get pod -n kube-system -o wide | grep attacher
Le retrait des pods a abouti lorsqu'aucun pod n'est affiché dans la sortie de votre interface de ligne de commande.
-
Vérifiez que la classe de stockage du plug-in IBM Cloud Block Storage Attacher est bien retirée.
oc get sc | grep attacher
Le retrait de la classe de stockage a abouti lorsqu'aucune classe de stockage n'est affichée dans la sortie de votre interface de ligne de commande.
Classique : Ajout manuel de stockage par blocs à des noeuds worker spécifiques
Utilisez cette option pour ajouter différentes configurations de stockage par blocs, ajouter du stockage par blocs à un sous-ensemble de noeuds worker uniquement ou pour disposer de plus de contrôle sur le processus de mise à disposition.
Les instructions figurant dans cette rubrique s'appliquent uniquement aux noeuds worker classiques. Si vous souhaitez attacher des blocs de stockage bruts et non formatés à un nœud de travailleur VPC, consultez la section Ajout de Block Storage for VPC bruts aux nœuds de travailleur.
-
Répertoriez les noeuds worker de votre cluster et notez leur adresse IP privée et la zone des noeuds worker non SDS où vous souhaitez ajouter une unité de stockage par blocs.
ibmcloud oc worker ls --cluster <cluster_name_or_ID>
-
Examinez les étapes 3 et 4 dans la rubrique Détermination de la configuration de votre stockage par blocs pour choisir le type, la taille et le nombre d'opérations d'entrée-sortie par seconde (IOPS) de l'unité de stockage par blocs que vous souhaitez ajouter à votre noeud worker non SDS.
-
Créez l'unité de stockage par blocs dans la même zone que votre noeud worker non SDS.
Exemple de mise à disposition d'un stockage par blocs de type endurance de 20 Go avec deux IOPS par Go.
ibmcloud sl block volume-order --storage-type endurance --size 20 --tier 2 --os-type LINUX --datacenter dal10
Exemple de mise à disposition de stockage par blocs de type performance de 20 Go avec 100 IOPS.
ibmcloud sl block volume-order --storage-type performance --size 20 --iops 100 --os-type LINUX --datacenter dal10
-
Vérifiez que l'unité de stockage par blocs est créée et notez l'
id
du volume. Remarque : si votre périphérique de stockage en bloc ne s'affiche pas immédiatement, attendez quelques minutes. Réexécutez ensuite cette commande.ibmcloud sl block volume-list
Exemple de sortie
id username datacenter storage_type capacity_gb bytes_used ip_addr lunId active_transactions 123456789 IBM02SL1234567-8 dal10 performance_block_storage 20 - 161.12.34.123 0 0
-
Consultez les détails de votre volume et notez les valeurs de
Target IP
etLUN Id
.ibmcloud sl block volume-detail <volume_ID>
Exemple de sortie
NAME Value ID 1234567890 User name IBM123A4567890-1 Type performance_block_storage Capacity (GB) 20 LUN Id 0 IOPS 100 Datacenter dal10 Target IP 161.12.34.123 # of Active Transactions 0 Replicant Count 0
-
Autorisez l'accès du noeud worker non SDS à l'unité de stockage par blocs. Remplacez
<volume_ID>
par l'ID volume de votre périphérique de stockage blocs que vous avez extrait précédemment, et<private_worker_IP>
avec l'adresse IP privée du nœud worker non-SDS où vous souhaitez connecter le périphérique.ibmcloud sl block access-authorize <volume_ID> -p <private_worker_IP>
Exemple de sortie
The IP address 123456789 was authorized to access <volume_ID>.
-
Vérifiez que votre noeud worker non SDS est bien autorisé et notez les valeurs de
host_iqn
,username
etpassword
.ibmcloud sl block access-list <volume_ID>
Exemple de sortie
ID name type private_ip_address source_subnet host_iqn username password allowed_host_id 123456789 <private_worker_IP> IP <private_worker_IP> - iqn.2018-09.com.ibm:ibm02su1543159-i106288771 IBM02SU1543159-I106288771 R6lqLBj9al6e2lbp 1146581
L'autorisation est validée lorsque les paramètres
host_iqn
,username
etpassword
sont affectés. -
Connectez les unités de stockage par blocs à vos noeuds worker.
Classique : Connexion de stockage par blocs brut à des noeuds worker non SDS
Pour connecter l'unité de stockage par blocs à un noeud worker non SDS, vous devez créer un volume persistant (PV) avec la classe de stockage IBM Cloud Block Volume Attacher et les détails de l'unité de stockage par blocs.
Les instructions figurant dans cette rubrique s'appliquent uniquement aux noeuds worker classiques. Si vous souhaitez attacher des blocs de stockage bruts et non formatés à un nœud de travailleur VPC, consultez la section Ajout de Block Storage for VPC bruts aux nœuds de travailleur.
- Vérifiez que vous avez ajouté manuellement du stockage par blocs brut, non formaté et non monté dans vos noeuds worker non SDS.
- Accédez à votre cluster Red Hat OpenShift.
- Installez le plug-in Block Storage Attacher.
-
Préparez la création du volume persistant.
-
Si vous avez utilisé le conteneur
mkpvyaml
, exécutez la commande suivante.-
Ouvrez le fichier
pv-<cluster_name>.yaml
.nano pv-<cluster_name>.yaml
-
Examinez la configuration de vos volumes persistants.
-
-
Si vous avez ajouté manuellement du stockage par blocs :**
-
Créez un fichier
pv.yaml
. La commande suivante crée le fichier avec l'éditeurnano
.nano pv.yaml
-
Ajoutez les détails de votre unité de stockage par blocs dans le volume persistant.
apiVersion: v1 kind: PersistentVolume metadata: name: <pv_name> annotations: ibm.io/iqn: "<IQN_hostname>" ibm.io/username: "<username>" ibm.io/password: "<password>" ibm.io/targetip: "<targetIP>" ibm.io/lunid: "<lunID>" ibm.io/nodeip: "<private_worker_IP>" ibm.io/volID: "<volume_ID>" spec: capacity: storage: <size> accessModes: - ReadWriteOnce hostPath: path: / storageClassName: ibmc-block-attacher
metadata.name
- Entrez un nom pour votre volume persistant.
ibm.io/iqn
- Entrez le nom d'hôte IQN que vous avez récupéré précédemment.
ibm.io/username
- Entrez le nom d'utilisateur de l'infrastructure IBM Cloud que vous avez récupéré précédemment.
ibm.io/password
- Entrez le mot de passe de l'infrastructure IBM Cloud que vous avez récupéré précédemment.
ibm.io/targetip
- Entrez l'adresse IP cible que vous avez récupérée précédemment.
ibm.io/lunid
- Entrez l'ID de numéro d'unité logique (LUN) de votre unité de stockage par blocs que vous avez récupéré précédemment.
ibm.io/nodeip
- Entrez l'adresse IP privée du noeud worker à laquelle connecter l'unité de stockage par blocs et que vous avez autorisée auparavant à accéder à cette unité.
ibm.io/volID
- Entrez l'ID du volume de stockage par blocs que vous avez récupéré précédemment.
storage
- Entrez la taille de l'unité de stockage par blocs que vous avez créée précédemment. Par exemple, si votre unité comporte 20 gigaoctets, entrez
20Gi
.
-
-
-
Créez le volume persistant pour connecter l'unité de stockage par blocs à votre noeud worker non SDS.
-
Si vous avez utilisé le conteneur
mkpvyaml
, exécutez la commande suivante.oc apply -f pv-<cluster_name>.yaml
-
Si vous avez ajouté du stockage par blocs manuellement, exécutez la commande suivante.
oc apply -f pv.yaml
-
-
Vérifiez que le stockage par blocs est bien connecté à votre noeud worker.
oc describe pv <pv_name>
Exemple de sortie
NAME: kube-wdc07-cr398f790bc285496dbeb8e9137bc6409a-w1-pv1 Labels: <none> Annotations: ibm.io/attachstatus=attached ibm.io/dm=/dev/dm-1 ibm.io/iqn=iqn.2018-09.com.ibm:ibm02su1543159-i106288771 ibm.io/lunid=0 ibm.io/mpath=3600a09803830445455244c4a38754c66 ibm.io/nodeip=10.176.48.67 ibm.io/password=R6lqLBj9al6e2lbp ibm.io/targetip=161.26.98.114 ibm.io/username=IBM02SU1543159-I106288771 kubectl.kubernetes.io/last-applied-configuration={"apiVersion":"v1","kind":"PersistentVolume","metadata":{"annotations":{"ibm.io/iqn":"iqn.2018-09.com.ibm:ibm02su1543159-i106288771","ibm.io/lunid":"0"... Finalizers: [] StorageClass: ibmc-block-attacher Status: Available Claim: Reclaim Policy: Retain Access Modes: RWO Capacity: 20Gi Node Affinity: <none> Message: Source: Type: HostPath (bare host directory volume) Path: / HostPathType: Events: <none>
L'unité de stockage par blocs est correctement connectée lorsque la valeur de ibm.io/dm est définie avec un ID d'unité, tel que
/dev/dm/1
, et que vous voyez ibm.io/attachstatus=attached dans la section Annotations de la sortie de votre interface de ligne de commande.
Si vous souhaitez déconnecter un volume, supprimez le volume persistant. Les volumes déconnectés sont toujours accessibles à un noeud worker spécifique et sont reconnectés lorsque vous créez un nouveau volume persistant avec la classe de stockage
IBM Cloud Block Volume Attacher pour connecter un autre volume au même noeud worker. Pour éviter de reconnecter l'ancien volume déconnecté, n'autorisez plus le noeud worker à accéder au volume déconnecté en exécutant la commande ibmcloud sl block access-revoke
.
La déconnexion du volume ne retire pas le volume de votre compte d'infrastructure IBM Cloud. Pour annuler la facturation de votre volume, vous devez retirer manuellement le stockage de votre compte d'infrastructure IBM Cloud.
VPC : Ajout de Block Storage for VPC brut aux nœuds de travail VPC à l'aide de l'API
Vous pouvez utiliser l'API Kubernetes Service pour attacher et détacher des données brutes, non formatées, à un nœud de travailleur dans votre cluster VPC Block Storage for Classic à un nœud de travailleur dans votre cluster VPC.
Vous pouvez connecter un volume à un noeud worker uniquement. Assurez-vous que le volume se trouve dans la même zone que le noeud worker pour parvenir à établir la connexion.
Vous pouvez également connecter, déconnecter et répertorier les pièces jointes de volume de vos noeuds worker à l'aide de l'interface de ligne de commande. Pour plus d'informations, voir la documentation de référence de l'interface de ligne de commande de stockage.
Les instructions figurant dans cette rubrique s'appliquent uniquement aux noeuds worker de VPC. Si vous souhaitez connecter du stockage par blocs brut, non formaté à un noeud worker classique, vous devez installer le plug-in IBM Cloud Block Storage Attacher.
Avant de commencer :
Accédez à votre cluster Red Hat OpenShift.
-
Vérifiez dans quelle région et dans quelle zone se trouve votre noeud worker VPC.
ibmcloud oc worker ls -c <cluster_name>
-
Déterminez le profil Block Storage for Classic qui répond le mieux à vos exigences en termes de capacité et de performances.
-
Mettez à disposition un volume Block Storage for Classic. Ce volume doit figurer dans le même groupe de ressources, dans la même région et dans la même zone que le noeud worker.
-
Récupérez votre jeton IAM.
ibmcloud iam oauth-tokens
-
Récupérez l'ID du noeud worker que vous souhaitez connecter à l'instance Block Storage for Classic. Veillez à sélectionner un noeud worker situé dans la même zone que votre volume Block Storage for Classic.
ibmcloud oc worker ls --cluster <cluster_name_or_ID>
-
Utilisez une demande
POST
pour connecter votre volume Block Storage for Classic au noeud worker.Exemple de demande
curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/createAttachment" -H "accept: application/json" -H "Authorization: <IAM_token>" -H "X-Auth-Resource-Group-ID: <resource_group>" -H "Content-Type: application/json" -d "{ \"cluster\": \"<cluster_name_or_ID>\", \"volumeID\": \"<volume_ID>\", \"worker\": \"<worker_ID>\"}"
IAM_token
- Jeton OAuth IAM pour votre session en cours. Vous pouvez extraire cette valeur en exécutant la commande
ibmcloud iam oauth-tokens
. cluster_name_or_ID
- ID ou nom unique affecté à votre cluster. Vous pouvez extraire cet ID en exécutant la commande
ibmcloud oc cluster ls
. worker_ID
- ID unique affecté au noeud worker auquel vous souhaitez connecter votre volume. Vous pouvez extraire cette valeur en exécutant la commande
ibmcloud oc worker ls -c <cluster_name>
. volume_ID
- ID unique affecté à votre volume Block Storage for Classic. Vous pouvez extraire la liste de vos volumes Block Storage for Classic en exécutant la commande
ibmcloud is volumes
.
Exemple de réponse.
{ "id": "0111-1aaa11a1-aa1a-111a-111b-1111a1dad1bc", "volume": { "name": "my-vol", "id": "r001-11aa0d59-a1aa-1a11-11ca-ba2bc11e01aa" }, "device": { "id": "" }, "name": "volume-attachment", "status": "attaching", "type": "data" }
-
Vérifiez la connexion en examinant les connexions de volume existantes pour un noeud worker de VPC.
Déconnexion de Block Storage for Classic brut et non formaté d'un noeud worker dans un cluster de VPC à l'aide de l'API
Vous pouvez utiliser une demande DELETE
pour déconnecter du stockage d'un noeud worker de VPC.
La déconnexion du stockage de votre cluster de VPC ne retire pas votre volume Block Storage for Classic ou les données stockées dans le volume. Vous continuez à être facturé jusqu'à ce que vous supprimiez manuellement le volume.
-
Identifiez le volume de stockage que vous souhaitez retirer et notez l'ID du volume.
ibmcloud is volumes
-
Obtenez des détails sur le volume. Cette commande renvoie l'ID du noeud worker et l'ID de connexion. Notez l'ID du noeud worker. Dans la commande suivante, volume_ID est renvoyé sous forme de "nom d'instance".
ibmcloud is volume <volume_ID>
-
Extrayez la liste de vos volumes persistants (PV). Cette commande renvoie la liste des volumes persistants que vous pouvez utiliser ensuite pour déterminer la réservation de volume persistant (PVC) utilisant le volume que vous souhaitez retirer.
oc get pv
-
Décrivez le volume persistant qui utilise le volume. Si vous ne savez pas quel PV utilise le volume que vous voulez supprimer, vous pouvez exécuter la commande
describe pv
sur chaque PV de votre cluster. Notez la réservation de volume persistant (PVC) qui utilise le volume.oc describe pv <pv_name>
-
Vérifiez si votre volume de stockage est utilisé par un pod. La commande suivante présente les pods qui montent le volume et la PVC associée. Si aucun pod n'est renvoyé, le stockage n'est pas utilisé.
oc get pods --all-namespaces -o=jsonpath='{range .items[*]}{"\n"}{.metadata.name}{":\t"}{range .spec.volumes[*]}{.persistentVolumeClaim.claimName}{" "}{end}{end}' | grep "<pvc_name>"
-
Si le pod utilisé par votre volume fait partie d'un déploiement, supprimez le déploiement. Si votre pod ne fait pas partie d'un déploiement, supprimez le pod.
oc delete deployment <deployment_name>
oc delete pod <pod_name>
-
Supprimez la réservation de volume persistant (PVC) et le volume persistant (PV).
oc delete pvc <pvc_name>
oc delete pv <pv_name>
-
Récupérez votre jeton IAM.
ibmcloud iam oauth-tokens
-
Déconnectez le stockage en utilisant une demande
POST
.Exemple de demande
curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/deleteAttachment" -H "accept: application/json" -H "Authorization: <IAM_token>" -H "X-Auth-Resource-Group-ID: <resource_group>" -H "Content-Type: application/json" -d "{ \"cluster\": \"<cluster_name_or_ID\", \"volumeAttachmentID\": \"<volume_attachment_ID>\", \"volumeID\": \"<volume_ID>\", \"worker\": \"<worker_ID>\"}"
IAM_token
- Jeton OAuth IAM pour votre session en cours. Vous pouvez extraire cette valeur en exécutant la commande
ibmcloud iam oauth-tokens
. cluster_name_or_ID
- ID ou nom unique affecté à votre cluster. Vous pouvez extraire cet ID en exécutant la commande
ibmcloud oc cluster ls
. worker_ID
- ID unique affecté au noeud worker auquel vous souhaitez connecter votre volume. Vous pouvez extraire cette valeur en exécutant la commande
ibmcloud oc worker ls -c <cluster_name>
. volume_ID
- ID unique affecté à votre volume Block Storage for Classic. Vous pouvez extraire la liste de vos volumes Block Storage for Classic en exécutant la commande
ibmcloud is volumes
. volume_attachment_ID
- ID unique affecté à la connexion de votre volume. Vous pouvez extraire cet ID en exécutant la commande
ibmcloud is volume <volume_ID>
.
Examen des détails de la connexion du volume pour un noeud worker de VPC à l'aide de l'API
Vous pouvez utiliser une demande GET
pour extraire les détails de connexion du volume pour un noeud worker de VPC.
-
Récupérez votre jeton IAM.
ibmcloud iam oauth-tokens
-
Extrayez l'ID du groupe de ressources (Resource Group ID) dans lequel est déployé votre cluster.
ibmcloud oc cluster get <cluster_name_or_ID> | grep "Resource Group ID"
-
Extrayez l'ID du noeud worker dont vous souhaitez obtenir les détails de connexion du volume. Veillez à sélectionner un noeud worker situé dans la même zone que votre instance Block Storage for Classic.
ibmcloud oc worker ls --cluster <cluster_name_or_ID>
-
Examinez la liste des connexions de volume existantes sur un noeud worker.
curl -X GET "https://containers.cloud.ibm.com/v2/storage/getAttachments?cluster=<cluster_ID>&worker=<worker_ID>" --header "X-Auth-Resource-Group-ID: <resource_group_ID>" --header "Authorization: <IAM_token>"
-
Extrayez les détails d'une connexion spécifique.
curl -X GET "https://containers.cloud.ibm.com/v2/storage/getAttachment?cluster=<cluster_ID>&worker=<worker_ID>&volumeAttachmentID=<volume_attachment_ID>" --header "X-Auth-Resource-Group-ID: <resource_group_ID>" --header "Authorization: <IAM_token>"
IAM_token
- Jeton OAuth IAM pour votre session en cours. Vous pouvez extraire cette valeur en exécutant la commande
ibmcloud iam oauth-tokens
. cluster_ID
- ID unique attribué à votre cluster. Vous pouvez extraire cet ID en exécutant la commande
ibmcloud oc cluster ls
. worker_ID
- ID unique affecté au noeud worker auquel vous souhaitez connecter votre volume. Vous pouvez extraire cette valeur en exécutant la commande
ibmcloud oc worker ls -c <cluster_name>
. volume_ID
- ID unique affecté à votre volume Block Storage for Classic. Vous pouvez extraire la liste de vos volumes Block Storage for Classic en exécutant la commande
ibmcloud is volumes
. volume_attachment_ID
- ID unique affecté à la connexion de votre volume. Vous pouvez extraire cet ID en exécutant la commande
ibmcloud is volume <volume_ID>
.
VPC : Connexion de Block Storage for VPC brut à des noeuds worker de VPC à l'aide de l'API
Vous pouvez utiliser la CLI Kubernetes Service pour connecter Block Storage for Classic brut non formaté à n nœud worker dans votre cluster VPC et l'en détacher.
Vous pouvez connecter un volume à un noeud worker uniquement. Assurez-vous que le volume se trouve dans la même zone que le noeud worker pour parvenir à établir la connexion.
Les instructions figurant dans cette rubrique s'appliquent uniquement aux noeuds worker de VPC. Si vous souhaitez connecter du stockage par blocs brut, non formaté à un noeud worker classique, vous devez installer le plug-in IBM Cloud Block Storage Attacher.
Avant de commencer :
Accédez à votre cluster Red Hat OpenShift.
-
Répertoriez vos volumes de stockage et notez l'ID du volume que vous souhaitez connecter.
ibmcloud is vols
-
Répertoriez les noeuds worker de votre cluster et notez l'ID de celui où vous souhaitez connecter votre volume.
ibmcloud oc worker ls -c <cluster_name_or_ID>
-
Connectez votre Block Storage for Classic à votre noeud worker de VPC.
ibmcloud oc storage attachment create --cluster <cluster_name_or_ID> --volume <volume> --worker <worker_ID>
Retrait de Block Storage for VPC brut des noeuds worker de VPC à l'aide de l'API
Vous pouvez retirer le stockage de votre noeud worker à l'aide de la commande ibmcloud oc storage attachment rm
.
-
Répertoriez vos volumes de stockage et notez l'ID du volume à supprimer.
ibmcloud is vols
-
Obtenez les détails de votre volume, par exemple, l'ID du noeud worker (
worker-id
) où le volume est connecté. L'IDworker-id
est répertorié sous Instance name dans la section Volume Attachment Instance Reference de la sortie de la commande.ibmcloud is vol <volume-ID>
Exemple de sortie
Volume Attachment Instance Reference Attachment type Instance ID Instance name Auto delete Attachment ID Attachment name data 0727_e18c10d7-7f18-48aa-b5ef-5ed163e54198 kube-bsaucubd07dhl66e4tgg-cluster-default-00000a19 false 0727-3bfe90b0-dc2d-498a-946b-8837a5dad7bc volume-attachment
-
Répertoriez les pièces jointes de stockage d'un noeud worker de votre cluster et notez l'ID de la pièce jointe que vous souhaitez retirer.
ibmcloud oc storage attachment ls -c <cluster> --worker <worker-id>
Exemple de sortie :
Listing volume attachments... OK ID Name Status Type Volume ID Volume Name Worker ID 0111-1a111aaa-1111-1111-111a-aaa1a1a11a11 volume-attachment attached boot a001-f11ed1e1-1aa1-11dc-b11d-a0dc111b1111 dissuade-anointer-errand-handbrake kube-aa1111aa11aaaaa11aa1-cluster-name-default-00000110
-
Supprimez la connexion de stockage.
ibmcloud oc storage attachment rm --attachment <attachment-ID> -c <cluster> --worker <worker-ID>
-
Vérifiez que votre stockage a été supprimé du noeud worker.
ibmcloud oc storage attachment ls -c <cluster-ID> --worker <worker-id>
Sauvegarde et restauration des données de la PVC pour le stockage de fichiers et le stockage par blocs
La charte Helm de sauvegarde et de restauration n'est pas prise en charge sur les clusters Satellite version 4.13 qui utilisent des noeuds worker CoreOS.
Avec la charte Helm IBM Cloud Backup Restore, vous pouvez créer une sauvegarde ponctuelle ou programmée des données stockées dans une réservation de volume persistant (PVC) de stockage de fichiers ou de stockage par blocs. Vos données sont stockées dans une instance de service IBM Cloud Object Storage que vous créez et possédez. Vous pouvez utiliser des sauvegardes existantes de votre instance de service IBM Cloud Object Storage pour restaurer des données dans une réservation de volume persistant sur votre cluster.
- Que se passe-t-il lorsque j'installe la carte Helm?
- Lorsque vous installez la charte Helm, un pod Kubernetes est créé dans votre cluster pour exécuter une sauvegarde ponctuelle ou régulière de vos données PVC ou restaurer les données d'IBM Cloud Object Storage dans une PVC. Vous configurez
votre sauvegarde ou votre restauration dans le fichier
values.yaml
fourni avec la carte Helm ou en définissant des options dans la commandehelm install
. - Quelles sont les limites dont je dois tenir compte?
- Si vous souhaitez effectuer une sauvegarde ou une restauration d'une réservation de volume persistant (PVC) de stockage par blocs, votre PVC ne doit pas être montée sur une application. Le stockage par blocs est monté avec un mode d'accès RWO. Ce type d'accès autorise uniquement le montage d'un pod à la fois sur le stockage par blocs. Pour sauvegarder ou restaurer vos données, vous devez retirer le pod qui utilise le stockage pour démonter la PVC. Après la sauvegarde ou la restauration des données, vous pouvez recréer votre pod et monter la PVC sauvegardée ou restaurée.
- De quoi ai-je besoin avant de commencer?
- Pour sauvegarder ou restaurer des données dans IBM Cloud Object Storage, vous devez configurer une instance de service IBM Cloud Object Storage, créer des données d'identification pour le service afin d'y accéder et créer un compartiment pouvant héberger vos données.
Configuration d'une instance de service IBM Cloud Object Storage
Créez et configurez une instance de service IBM Cloud Object Storage qui servira de référentiel pour les données que vous souhaitez sauvegarder.
- Créez une instance de service IBM Cloud Object Storage qui utilise des données d'identification HMAC.
- Stockez vos données d'identification IBM Cloud Object Storage dans un secret Kubernetes.
- Créez votre premier compartiment IBM Cloud Object Storage.
- Dans le volet de navigation de la page des détails du service, cliquez sur Compartiments.
- Cliquez sur Créer un compartiment. Une boîte de dialogue s'affiche.
- Entrez un nom unique pour votre compartiment. Le nom doit être unique dans IBM Cloud Object Storage sur toutes les régions et sur tous les comptes IBM Cloud.
- Dans la liste Résilience, sélectionnez le niveau de disponibilité souhaité pour vos données. Pour plus d'informations, voir Régions IBM Cloud Object Storage et noeuds finaux.
Pour les clusters de VPC, notez le noeud final direct. Par exemple:
s3.direct.us.cloud-object-storage.appdomain.cloud
. - Changez la valeur de Site pour qu'elle corresponde à la région dans laquelle vous voulez stocker vos données. Gardez à l'esprit que pour des raisons juridiques, vous ne serez peut-être pas autorisé à stocker vos données dans toutes les régions.
- Cliquez sur Créer.
- Extrayez le nom d'hôte IBM Cloud Object Storage de votre compartiment.
- Cliquez sur le nom du seau que vous avez créé à l'étape précédente.
- Dans le volet de navigation de la page des détails du service, cliquez sur Compartiments > Configuration.
- Notez l'URL publique que vous pouvez utiliser pour accéder aux données de votre compartiment.
Pour plus d'informations sur la configuration de votre instance de service, voir la documentation IBM Cloud Object Storage.
Utilisation d'IBM Cloud Object Storage pour sauvegarder et restaurer les données de la PVC
Vous pouvez utiliser la charte Helm IBM Cloud Backup Restore pour sauvegarder des données dans une réservation de volume persistant (PVC) de stockage de fichiers ou de stockage par blocs dans IBM Cloud Object Storage ou restaurer des données d'IBM Cloud Object Storage dans une PVC sur votre cluster.
Avant de commencer :
-
Vérifiez que vous disposez d'une réservation de volume persistant dans laquelle sauvegarder ou restaurer des données. Pour plus d'informations sur la création d'une PVC, voir Ajout de stockage de fichiers à des applications et Ajout de stockage par blocs à des applications.
-
Si vous souhaitez effectuer une sauvegarde de PVC de stockage par blocs, assurez-vous que votre PVC n'est pas montée sur une application. Le stockage par blocs est monté avec un mode d'accès RWO. Ce type d'accès autorise uniquement le montage d'un pod à la fois sur le stockage par blocs. Pour sauvegarder vos données, vous devez retirer le pod d'application qui monte le stockage. Pour vérifier si un pod est monté sur votre PVC, exécutez la commande suivante.
oc get pods --all-namespaces -o=jsonpath='{range .items[*]}{"\n"}{.metadata.name}{":\t"}{range .spec.volumes[*]}{.persistentVolumeClaim.claimName}{" "}{end}{end}' | grep "<pvc_name>"
-
Suivez les instructions d'installation du client Helm sur votre machine locale et configurez les référentiels de la charte Helm IBM Cloud.
Vous pouvez déployer le pod ibm-storage-backup
ou ibm-storage-restore
en éditant et en appliquant le fichier values.yaml
de la charte Helm ou en exécutant la commande helm install
dans l'interface
de ligne de commande.
Pour sauvegarder ou restaurer une réservation de volume persistant en éditant le fichier values.yaml
:
-
Téléchargez la version de la charte Helm la plus récente sur votre machine locale.
helm fetch --untar iks-charts/ibmcloud-backup-restore
-
Ouvrez le fichier
values.yaml
dans l'éditeur de ligne de commandenano
.nano ibmcloud-backup-restore/values.yaml
-
Configurez votre charte Helm pour sauvegarder ou restaurer les données PVC. Vous pouvez configurer la sauvegarde de plusieurs PVC.
Exemple de création d'un pod de sauvegarde en configurant le fichier
values.yaml
:image: repository: icr.io/iks-charts/ibmcloud-backup-restore pullPolicy: Always tag: latest ACCESS_KEY_ID: # Example: 10110abab1111bbb111aa1aaa111b1a1 SECRET_ACCESS_KEY: # Example: a1aba11aaa11b11b11aa1111a1111ba111111111a0b1b11a ENDPOINT: # Example: s3.us-east.cloud-object-storage.appdomain.cloud BUCKET_NAME: # Example: my-bucket BACKUP_NAME: # Example: my_backup PVC_NAMES: - # Example: my_pvc - # Optional example: my_pvc2 CHART_TYPE: # Example: backup or restore BACKUP_TYPE: # Example: incremental SCHEDULE_TYPE: # Example: periodic SCHEDULE_INFO: # Example: weekly
ACCESS_KEY_ID
- Entrez l'ID de clé d'accès des données d'identification pour le service IBM Cloud Object Storage que vous avez récupéré précédemment.
SECRET_ACCESS_KEY
- Entrez la clé d'accès secrète des données d'identification pour le service IBM Cloud Object Storage que vous avez récupérée précédemment.
ENDPOINT
- Entrez le noeud final d'API IBM Cloud Object Storage s3 correspondant à votre compartiment que vous avez récupéré précédemment.
BUCKET_NAME
- Sauvegarde : entrez le nom du compartiment IBM Cloud Object Storage que vous avez créé précédemment. Vous utilisez ce compartiment pour stocker les données PVC lorsque vous effectuez une sauvegarde. Restauration : entrez le nom du compartiment IBM Cloud Object Storage dans lequel est stockée votre sauvegarde.
BACKUP_NAME
- Sauvegarde : entrez le nom de la sauvegarde que vous souhaitez créer dans IBM Cloud Object Storage. Restauration : entrez le nom de la sauvegarde que vous avez créée avec la charte Helm IBM Cloud Backup Restore dans IBM Cloud Object Storage. Si votre instance de service IBM Cloud Object Storage contient plusieurs sauvegardes intégrales, la réservation de volume persistant est restaurée avec les données de la dernière sauvegarde intégrale. Si vous avez des sauvegardes incrémentielles, la réservation de volume persistant est restaurée avec les données de la dernière sauvegarde intégrale, y compris toutes les sauvegardes incrémentielles jusqu'au jour où vous lancez la restauration.
PVC_NAMES
- Sauvegarde : entrez le nom du PVC que vous souhaitez sauvegarder. Pour sauvegarder plusieurs PVC, ajoutez chaque PVC dans la liste des PVC. Pour répertorier les PVC disponibles de votre cluster pouvant être sauvegardées,
exécutez la commande
oc get pvc
. Restauration : entrez le nom de la PVC dans laquelle vous souhaitez restaurer les données d'IBM Cloud Object Storage. Vous ne pouvez restaurer des données que dans une seule PVC à la fois. Pour répertorier les PVC disponibles dans votre cluster dans lesquelles vous pouvez restaurer des données, exécutez la commandeoc get pvc
. CHART_TYPE
- Entrez le nom du type de charte que vous souhaitez déployer. Entrez
backup
pour déployer la charte de sauvegarde. Entrezrestore
pour déployer la charte de restauration. BACKUP_TYPE
- Requis uniquement pour les sauvegardes. Entrez
full
pour créer une sauvegarde intégrale ouincremental
si vous souhaitez uniquement sauvegarder les fichiers nouveaux ou modifiés. Si vous choisissezincremental
, vous devez spécifier les optionsSCHEDULING_INFO
etSCHEDULING_TYPE
. Si vous n'indiquez pas l'optionBACKUP_TYPE
, une sauvegarde intégrale est créée par défaut. SCHEDULE_TYPE
- Requis uniquement pour les sauvegardes. Entrez
periodic
pour créer des sauvegardes planifiées ou laissez cette option vide pour créer une sauvegarde ponctuelle. Si vous envisagez de créer des sauvegardes régulières, vous devez définir l'intervalle de sauvegarde dans l'optionSCHEDULE_INFO
. SCHEDULE_INFO
- Requis uniquement pour les sauvegardes. Si vous souhaitez créer des sauvegardes régulières, vous devez déterminer un planning de sauvegarde. Choisissez
hourly
(horaire),daily
(quotidienne) ouweekly
(hebdomadaire). Si vous définissez cette option, vous devez indiquer la valeurSCHEDULE_TYPE
pour l'optionperiodic
.
-
Sauvegardez et fermez le fichier
values.yaml
. -
Installez la charte Helm avec vos paramètres personnalisés dans le fichier
values.yaml
. Lorsque vous installez la charte Helm et que vous configurez une sauvegarde ou une restauration, un podibm-storage-backup
ouibm-storage-restore
est déployé dans votre cluster. Le pod de sauvegarde effectue une sauvegarde des données de votre PVC vers IBM Cloud Object Storage et le pod de restauration restaure les données dans une PVC. Remplacez<release_name>
par un nom pour votre graphique Helm. Prenez soin d'installer les pods de sauvegarde et de restauration dans la même zone que la PVC que vous souhaitez sauvegarder ou restaurer.-
Installez la charte Helm à l'aide de la commande
helm install
.helm install <release_name> ./ibmcloud-backup-restore -n <namespace>
Exemple de sortie pour une sauvegarde :
NAME: <release_name> LAST DEPLOYED: Mon Jan 20 09:17:02 2020 NAMESPACE: default STATUS: deployed REVISION: 1 TEST SUITE: None NOTES: Thank you for installing: ibmcloud-backup-restore. Your release is named: <release_name> Please refer Chart README.md file for creating a sample PVC Please refer Chart RELEASE.md to see the release details/fixes
-
Facultatif : installez la carte Helm en définissant des options dans la commande
helm install
. Vous pouvez nommer votre édition en indiquant le paramètre--name
.helm install <release_name> --set ACCESS_KEY_ID=<access_key_ID> --set SECRET_ACCESS_KEY=<secret_access_key> --set ENDPOINT=<public_bucket_endpoint> --set BUCKET_NAME=<bucket_name> --set BACKUP_NAME=<backup_name> --set PVC_NAMES[0]=<pvc_name1> --set PVC_NAMES[1]=<pvc_name2> --set CHART_TYPE=backup --set BACKUP_TYPE=<backup_type> --set SCHEDULE_TYPE=<schedule_type> --set SCHEDULE_INFO=<schedule_info> ./ibmcloud-backup-restore
-
-
Vérifiez que la sauvegarde ou la restauration a abouti.
Sauvegarde :
-
Vérifiez que le statut du pod
ibm-storage-backup
est Running.oc get pods -A | grep backup
Exemple de sortie
ibm-storage-backup 1/1 Running 0 64m
-
Consultez les journaux du pod
ibm-storage-backup
pour vérifier que votre sauvegarde a abouti. Lorsque vous voyez le message... backup completed
dans les journaux, votre sauvegarde s'est terminée avec succès.oc logs ibm-storage-backup
Exemple de sortie pour les sauvegardes quotidiennes.
[2019-04-18 16:01:51,157] [utilities : 151] [INFO] *****************Start logging to ./Backup.log [2019-04-18 16:01:51,158] [backup : 48] [INFO] Starting backup: [2019-04-18 16:01:51,158] [configureOS : 66] [INFO] Configuring duplicity with IBM CloudObjectStorage i.e s3. [2019-04-18 16:01:51,158] [backup : 62] [INFO] Configuration done!!! [2019-04-18 16:01:51,158] [backup : 78] [INFO] Got all required input from config file!! [2019-04-18 16:01:52,366] [backup : 119] [WARNING] Incremental backup was not created [2019-04-18 16:01:52,366] [backup : 120] [INFO] duplicity --no-encryption incremental /myvol s3://s3.us-south.cloud-object-storage.appdomain.cloud/mybucket/helm-backup command failed due to Fatal Error: Unable to start incremental backup. Old signatures not found and incremental specified [2019-04-18 16:01:52,367] [backup : 121] [INFO] A full backup is required before incremental backups can begin. Creating a one-time full backup and will run incremental backups for scheduled backups. [2019-04-18 16:01:54,357] [backup : 129] [INFO] Full backup completed [2019-04-18 16:01:54,357] [backup : 130] [INFO] Local and Remote metadata are synchronized, no sync needed. Last full backup date: none --------------[ Backup Statistics ]-------------- StartTime 1555603313.31 (Thu Apr 18 16:01:53 2019) EndTime 1555603313.32 (Thu Apr 18 16:01:53 2019) ElapsedTime 0.01 (0.01 seconds) SourceFiles 3 SourceFileSize 20495 (20.0 KB) NewFiles 3 NewFileSize 20495 (20.0 KB) DeletedFiles 0 ChangedFiles 0 ChangedFileSize 0 (0 bytes) ChangedDeltaSize 0 (0 bytes) DeltaEntries 3 RawDeltaSize 15 (15 bytes) TotalDestinationSizeChange 183 (183 bytes) Errors 0 ------------------------------------------------- [2019-04-18 16:01:54,357] [backup : 162] [INFO] Scheduling backup as per configurations, please don't stop this program or run this in background !!! [2019-04-18 16:01:54,358] [backup : 166] [INFO] Schedule info is: ['daily'] [2019-04-18 16:01:54,358] [backup : 172] [INFO] Scheduled for daily!!!
-
-
Vérifiez que vos données ont été sauvegardées ou restaurez.
-
Sauvegarde :
- Recherchez votre instance de service IBM Cloud Object Storage dans la Liste de ressources IBM Cloud.
- Dans la navigation, sélectionnez Buckets et cliquez sur le bucket que vous avez utilisé dans votre configuration de sauvegarde. La sauvegarde s'affiche en tant qu'objet dans votre compartiment.
- Examinez les fichiers compressés. Vous pouvez télécharger le fichier
*.gz
, extraire le fichier et vérifier les données sauvegardées.
-
Restaurer :
-
Créez un fichier
deployment.yaml
avec un pod utilisé pour monter la PVC contenant vos données restaurées. L'exemple suivant déploie un podnginx
qui monte la PVC dans le répertoire de montage nommé/test
.apiVersion: apps/v1 kind: Deployment metadata: name: restore labels: app: nginx spec: selector: matchLabels: app: nginx template: metadata: labels: app: nginx spec: containers: - image: nginx name: nginx volumeMounts: - name: my-volume # Example: my_volume mountPath: /test # Example: /test volumes: - name: my-volume # Example: my_volume persistentVolumeClaim: claimName: my-actual-pvc-name # Example: my_pvc
spec.containers.image
- Nom de l'image que vous désirez utiliser. Pour répertorier les images disponibles dans votre compte IBM Cloud Container Registry, exécutez la commande
ibmcloud cr image-list
. spec.containers.name
- Nom du conteneur que vous désirez déployer dans votre cluster.
spec.containers.volumeMounts.mountPath
- Chemin absolu du répertoire où est monté le volume dans le conteneur. Les données écrites dans le chemin de montage sont stockées sous le répertoire racine dans votre instance de stockage par blocs physique. Si vous souhaitez partager un volume entre différentes applications, vous pouvez spécifier des sous-chemins de volume pour chacune de vos applications.
spec.containers.volumeMounts.name
- Nom du volume à monter sur votre pod.
volumes.name
- Nom du volume à monter sur votre pod. Ce nom est généralement identique à
volumeMounts/name
. volumes.persistentVolumeClaim.claimName
- Nom de la réservation de volume persistant (PVC) liée au volume persistant (PV) que vous voulez utiliser.
-
Créez le déploiement.
oc apply -f deployment.yaml
-
Vérifiez que le statut de votre pod est Running.
Si vous constatez que le statut de votre pod
ibm-storage-restore
ne passe pas à Completed ou CrashLoopBackOff, il se peut que la restauration de vos données ait échoué. Exécutez la commandeoc logs ibm-storage-restore
pour rechercher la cause première de l'échec.oc get pods | grep restore
Exemple de sortie
restore-7dfc6f4c78-wkcqp 1/1 Running 0 3m54s
-
Connectez-vous à votre pod.
oc exec <pod_name> -it bash
-
Accédez au répertoire de montage que vous avez spécifié dans votre fichier YAML de déploiement.
cd <mount_directory>
-
Répertoriez les fichiers de votre répertoire de montage pour vérifier si toutes vos données ont été restaurées dans ce répertoire.
ls
-
Supprimez l'installation de la charte Helm de votre cluster. Cette étape est obligatoire si vous avez restauré les données dans une réservation de volume persistant de stockage par blocs. Le stockage par blocs est monté avec un mode d'accès RWO. Ce type d'accès autorise uniquement le montage d'un pod à la fois sur le stockage par blocs. Etant donné que le pod
ibm-storage-restore
effectue déjà le montage de la PVC, vous devez retirer le pod pour libérer la PVC de sorte à pouvoir la monter sur un autre pod dans votre cluster.helm uninstall <release_name> -n <namespace>
-
Vous avez restauré votre sauvegarde avec succès. Vous pouvez désormais monter la réservation de volume persistant (PVC) qui lie le volume persistant (PV) à un autre pod dans votre cluster pour accéder aux fichiers restaurés. Si les données de conteneur qui ont été sauvegardées incluaient un utilisateur non root, vous devez ajouter des droits non root à votre nouveau conteneur. Pour plus d'informations, voir Ajout d'un accès utilisateur non root aux volumes.
-
-
Configuration d'IBM Cloud Monitoring pour les volumes de stockage
Configurez des alertes dans IBM Cloud Monitoring pour vos charges de travail qui utilisent des volumes de stockage. Pour plus d'informations, voir Alertes.
Lorsqu'un volume de stockage est arrêté, vos pods d'application qui utilisent du stockage comportent peu d'opérations d'E-S de système de fichiers, comportent des erreurs réseau ou tombent en panne, ce qui entraîne la baisse du nombre de répliques.
Vous pouvez configurer des alertes dans IBM Cloud Monitoring pour être informé si les opérations du système de fichiers pour votre application tombent sous un seuil spécifique, si des erreurs de réseau se produisent, ou si les pods de votre
application n'atteignent pas l'état Ready
.
-
Dans la console, sélectionnez le cluster dans lequel vous souhaitez configurer des alertes pour vos volumes de stockage.
-
Dans la section Surveillance, cliquez sur Connecter pour connecter une instance IBM Cloud Monitoring existante à votre cluster. Si vous ne disposez pas d'une instance, cliquez sur Créer une instance pour en créer une. Pour plus d'informations sur la configuration d'une instance IBM Cloud Monitoring, voir Mise à disposition d'une instance.
-
Cliquez sur le bouton Lancer pour ouvrir le tableau de bord d'IBM Cloud Monitoring.
-
Créez des alertes d'utilisation de système de fichiers pour une application qui s'exécute dans votre cluster.
- A partir de la console IBM Cloud Monitoring, cliquez sur Présentation > Charges de travail.
- Sélectionnez l'espace de noms dans lequel votre application est déployée. Recherchez votre application, cliquez sur l'icône en forme de flèche sur votre application et sélectionnez Présentation de pod Kubernetes.
- Dans la section Utilisation du système de fichiers, examinez la vignette Bande passante d'E-S de fichier par pod.
- Passez en revue la bande passante d'E-S de fichier à partir de la dernière fenêtre de temps d'un jour ou d'une semaine pour déterminer la bande passante moyenne. Vous pouvez utiliser la bande passante moyenne comme seuil pour définir une alerte lorsque la bande passante des E/S de fichiers est inférieure à la moyenne pendant un certain temps. Par exemple, si la bande passante moyenne des E/S de fichiers pour votre application est de 300B/s, vous pouvez créer une alerte lorsque l'utilisation du réseau reste inférieure à 300B/s pendant un certain temps.
- Dans la vignette Bande passante d'E-S de fichier par pod, créez une alerte en cliquant sur le menu Options, puis sur Créer une alerte.
- Ouvrez la section Notification du menu d'alerte et créez ou sélectionnez un canal de notification d'alerte.
- Sauvegardez votre alerte.
- Répétez ces étapes pour toutes les applications déployées dans votre cluster.
- Testez l'alerte que vous avez créée en éditant le seuil que vous avez configuré pour déclencher manuellement l'alerte. Par exemple, si vous définissez une alerte d'utilisation de système de fichiers qui doit se déclencher lorsque l'utilisation
est inférieure à 300B/s pendant 5 minutes, augmentez le seuil pour qu'il soit supérieur à l'utilisation en cours de votre application pendant 5 minutes et sélectionnez l'option
at least once
. - Vérifiez que l'alerte est déclenchée après 5 minutes. Une fois que vous avez vérifié l'alerte, réinitialisez les valeurs avec les valeurs que vous avez configurées précédemment.
-
Créez une alerte d'utilisation de réseau pour une application qui s'exécute dans votre cluster.
- A partir de la console IBM Cloud Monitoring, cliquez sur Présentation > Charges de travail.
- Sélectionnez l'espace de noms dans lequel votre application est déployée. Recherchez votre application, cliquez sur l'icône en forme de flèche sur votre application et sélectionnez Présentation de pod Kubernetes.
- Dans la section Utilisation de réseau, examinez la vignette Nombre de demandes réseau par pod.
- Passez en revue le nombre moyen de demandes réseau par pod à partir de la dernière fenêtre de temps d'un jour ou d'une semaine pour déterminer le seuil.
- Dans la vignette Nombre de demandes réseau par pod, créez une alerte en cliquant sur le menu Options, puis sur Créer une alerte. Définissez les paramètres d'alerte en fonction du seuil que vous avez observé. Par exemple, si l'utilisation du réseau reste inférieure au seuil pendant un certain temps, l'alerte est déclenchée.
- Ouvrez la section Notification du menu d'alerte et créez ou sélectionnez un canal de notification d'alerte.
- Sauvegardez votre alerte.
- Répétez ces étapes pour toutes les applications déployées dans votre cluster.
- Testez l'alerte que vous avez créée en éditant le seuil que vous avez configuré pour déclencher manuellement l'alerte. Par exemple, si vous définissez une alerte qui doit se déclencher lorsque le nombre de demandes réseau par pod est inférieur
à 3/s pendant 5 minutes, éditez votre seuil d'alerte pour qu'il soit inférieur à celui que vous avez observé pendant 5 minutes et sélectionnez l'option
at least once
. - Vérifiez que l'alerte est déclenchée après 5 minutes. Une fois que vous avez vérifié l'alerte, réinitialisez les valeurs avec les valeurs que vous avez configurées précédemment.
-
Créez une alerte de disponibilité de pod pour une application qui s'exécute dans votre cluster.
- A partir de la console IBM Cloud Monitoring, cliquez sur Présentation > Charges de travail.
- Sélectionnez l'espace de noms dans lequel votre application est déployée. Recherchez votre application, cliquez sur l'icône en forme de flèche sur votre application et sélectionnez Présentation de pod Kubernetes.
- Dans la section Etat de santé du pod, examinez la vignette Disponibilité du pod.
- Passez en revue la disponibilité moyenne du pod à partir de la dernière fenêtre de temps d'un jour ou d'une semaine pour déterminer le seuil.
- Vérifiez le fichier de configuration de votre application concernant le nombre de répliques demandées. Vous pouvez utiliser ce nombre comme seuil pour l'envoi d'alertes lorsque le nombre de pods disponibles est inférieur à votre nombre de répliques demandées pour votre application. Si vous avez demandé 3 répliques de votre application, vous pouvez définir une alerte qui se déclenche lorsque le nombre de pods disponibles reste inférieur au nombre de répliques demandées pendant un certain temps, par exemple, 30 minutes. Dans cet exemple, lorsque la disponibilité du pod reste inférieure aux 3 répliques demandées, l'alerte se déclenche.
- Dans la vignette Disponibilité du pod, créez une alerte en cliquant sur le menu Options, puis sur Créer une alerte. Définissez les paramètres d'alerte en fonction du seuil que vous avez observé et des répliques d'application que vous avez demandées.
- Ouvrez la section Notification du menu d'alerte et créez ou sélectionnez un canal de notification d'alerte.
- Sauvegardez votre alerte.
- Répétez ces étapes pour toutes les applications déployées dans votre cluster.
- Testez l'alerte que vous avez créée en éditant le seuil que vous avez configuré pour déclencher manuellement l'alerte. Par exemple, si vous définissez une alerte de disponibilité de pod qui doit se déclencher lorsque le nombre de pods
disponibles est inférieur à 3 pendant 5 minutes, éditez votre seuil d'alerte pour qu'il soit inférieur à 4 pods pendant 5 minutes et sélectionnez l'option
at least once
. - Vérifiez que l'alerte est déclenchée après 5 minutes. Une fois que vous avez vérifié l'alerte, réinitialisez les valeurs avec les valeurs que vous avez configurées précédemment.
Identification et résolution des incidents de stockage de persistance lorsqu'une alerte IBM Cloud Monitoring est déclenchée
Lorsqu'une alerte est déclenchée, examinez les détails de l'alerte dans IBM Cloud Monitoring et consultez les guides de traitement des incidents relatifs au stockage persistant, aux applications, aux noeuds worker et aux clusters pour trouver la cause première de l'alerte. Les alertes que vous définissez peuvent ne pas être liée à un problème de volume de stockage, mais à des problèmes qui se sont produits dans votre application, sur le noeud worker ou dans le cluster.