Aller au contenu

Lab Adv 01 : Velero - Sauvegarde et restauration de cluster

  • Installer Velero sur un cluster Kubernetes.
  • Configurer Velero pour sauvegarder et restaurer des ressources Kubernetes.
  • Tester la sauvegarde et la restauration d’un pod avec un hook pre-backup.
  • Vérifier le contenu du backup dans un bucket S3 d’OUTSCALE.
  1. Un cluster Kubernetes opérationnel fourni par OKS.
  2. Accès à la CLI kubectl.
  3. Droits administrateurs sur le cluster.
  4. Outils nécessaires :
    • aws-cli : Outil en ligne de commande pour interagir avec AWS S3. Vous pouvez l’installer en suivant les instructions ici.
    • s3cmd : Un autre outil pour interagir avec S3, notamment pour la gestion des fichiers dans les buckets. L’installation est décrite ici.
  5. Accès à un compte OUTSCALE :
    • Vous aurez besoin d’un compte OUTSCALE pour créer un bucket et interagir avec celui-ci.
  6. Configurer AWS CLI :
    • Une fois AWS CLI installé, vous devez configurer les informations d’authentification en exécutant la commande suivante :
Terminal window
aws configure

Cela vous demandera vos clés d’accès AWS (Access Key et Secret Key), la région (par exemple eu-west-2), et le format de sortie préféré (par défaut json).

  1. Vérifier les outils installés :
    • Avant de continuer, vérifiez que aws-cli et s3cmd sont bien installés et accessibles :
Terminal window
# Vérifier aws-cli
aws --version
# Vérifier s3cmd
s3cmd --version

Si l’un des outils n’est pas installé, suivez les liens fournis plus haut pour l’installer.

  1. Créer un bucket S3 dans OUTSCALE :
    • Vous devez avoir un bucket S3 pour y stocker vos backups Velero. Suivez les étapes ci-dessous pour créer et configurer ce bucket dans OUTSCALE.
Terminal window
octl kube cluster kubeconfig my-cluster > kubeconfig.yaml
export KUBECONFIG=./kubeconfig.yaml
Terminal window
kubectl get nodes

Créer un bucket nommé velero-bucket-oks, remplacez TRIGRAMME par votre trigramme pour créer un bucket unique :

Terminal window
aws s3api create-bucket --bucket velero-bucket-oks-TRIGRAMME --endpoint https://oos.eu-west-2.outscale.com

Vérifier que le bucket a bien été créé :

Terminal window
aws s3api list-buckets --endpoint https://oos.eu-west-2.outscale.com

Créer un fichier bucket-policy.json avec le contenu suivant :

{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": "*",
"Action": [
"s3:ListBucket"
],
"Resource": "arn:aws:s3:::velero-bucket-oks-TRIGRAMME"
},
{
"Effect": "Allow",
"Principal": "*",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject"
],
"Resource": "arn:aws:s3:::velero-bucket-oks-TRIGRAMME/*"
}
]
}

Appliquer la policy au bucket :

Terminal window
aws s3api put-bucket-policy --bucket velero-bucket-oks-TRIGRAMME --policy file://bucket-policy.json --endpoint https://oos.eu-west-2.outscale.com

Vérifier que la policy a bien été appliquée :

Terminal window
aws s3api get-bucket-policy --bucket velero-bucket-oks-TRIGRAMME --endpoint https://oos.eu-west-2.outscale.com

Installer Velero avec Helm :

Terminal window
helm repo add vmware-tanzu https://vmware-tanzu.github.io/helm-charts
helm install velero vmware-tanzu/velero \
--namespace velero \
--create-namespace \
--set-file credentials.secretContents.cloud="$HOME/.aws/credentials" \
--set 'configuration.backupStorageLocation[0].name=default' \
--set 'configuration.backupStorageLocation[0].provider=aws' \
--set 'configuration.backupStorageLocation[0].bucket=velero-bucket-oks-TRIGRAMME' \
--set 'configuration.backupStorageLocation[0].config.region=eu-west-2' \
--set 'configuration.backupStorageLocation[0].config.s3Url=https://oos.eu-west-2.outscale.com' \
--set 'configuration.volumeSnapshotLocation[0].name=default' \
--set 'configuration.volumeSnapshotLocation[0].provider=aws' \
--set 'configuration.volumeSnapshotLocation[0].config.region=eu-west-2' \
--set 'initContainers[0].name=velero-plugin-for-aws' \
--set 'initContainers[0].image=velero/velero-plugin-for-aws:v1.14.2' \
--set 'initContainers[0].volumeMounts[0].mountPath=/target' \
--set 'initContainers[0].volumeMounts[0].name=plugins'

Créez un fichier nginx-hook-pod.yaml avec un exemple de configuration d’un pod avec un hook pre-backup :

---
apiVersion: v1
kind: Pod
metadata:
name: my-app
annotations:
pre.hook.backup.velero.io/command: '["/bin/sh", "-c", "echo Running_pre-backup_hook"]'
spec:
containers:
- name: my-app-container
image: nginx

Appliquez la configuration :

Terminal window
kubectl apply -f nginx-hook-pod.yaml

Créer un backup incluant le namespace default :

Terminal window
velero backup create my-backup-with-hook --include-namespaces default --wait

Vérifier si le backup a bien été effectué :

Terminal window
velero backup get

Consulter les logs du pod pour s’assurer que le hook a bien été exécuté :

Terminal window
velero backup logs my-backup-with-hook

Vous devriez voir le message Running pre-backup hook dans les logs.

Vérification du Contenu du Backup dans le Bucket OUTSCALE

Section intitulée « Vérification du Contenu du Backup dans le Bucket OUTSCALE »

Lister les objets dans le bucket OUTSCALE avec s3cmd (remplacez TRIGRAMME par votre trigramme) :

Terminal window
s3cmd ls s3://velero-bucket-oks-TRIGRAMME

Ou avec AWS CLI :

Terminal window
aws s3 ls s3://velero-bucket-oks-TRIGRAMME --recursive --endpoint https://oos.eu-west-2.outscale.com

Supprimer toutes les ressources du namespace default :

Terminal window
kubectl delete all --all -n default

Restaurer le backup :

Terminal window
velero restore create --from-backup my-backup-with-hook --wait

Vérifier que les ressources ont bien été restaurées :

Terminal window
kubectl get all -n default

Dans ce lab, vous avez appris à installer Velero, à configurer un backup avec un hook pre-backup, et à vérifier le contenu du backup dans un bucket S3 d’OUTSCALE. Vous avez également testé la restauration des ressources à partir du backup. Vous êtes maintenant prêt à utiliser Velero pour gérer vos sauvegardes et restaurations de cluster Kubernetes.