Aller au contenu principal

Intégration CI/CD

SailOps prend en charge deux approches pour automatiser les déploiements :

ApprocheUsage recommandéFonctionnement
Appels API directsMise à jour simple d'image ou redémarrageAppeler des endpoints comme PATCH /containers/{name}
Stack EngineGestion complète d'infrastructureAppliquer un fichier YAML déclaratif

Les deux approches utilisent les clés API. Stockez la clé dans les secrets CI/CD et ne la commitez jamais.

Prérequis​

  • Un projet SailOps.
  • Une clé API du projet.
  • Un registry d'images accessible par SailOps.
  • Un secret CI/CD nommé par exemple SAILOPS_API_KEY.

GitHub Actions : mettre à jour un conteneur​

name: Build and deploy

on:
push:
branches: [main]

env:
IMAGE: ghcr.io/${{ github.repository }}
CONTAINER_NAME: my-api

jobs:
deploy:
runs-on: ubuntu-latest
permissions:
contents: read
packages: write
steps:
- uses: actions/checkout@v4

- name: Log in to GHCR
uses: docker/login-action@v3
with:
registry: ghcr.io
username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }}

- name: Build and push
uses: docker/build-push-action@v6
with:
push: true
tags: ${{ env.IMAGE }}:${{ github.sha }}

- name: Deploy to SailOps
run: |
curl -sf -X PATCH \
-H "X-Api-Key: ${{ secrets.SAILOPS_API_KEY }}" \
-H "Content-Type: application/json" \
-d "{\"image\":\"${{ env.IMAGE }}:${{ github.sha }}\"}" \
"https://app.sailops.io/api/public/api/v1/containers/${{ env.CONTAINER_NAME }}"
PATCH plutôt que PUT

Utilisez PATCH pour changer uniquement l'image. PUT remplace la spec complète du conteneur.

Appliquer une stack​

curl -sf -X POST \
-H "X-Api-Key: $SAILOPS_API_KEY" \
-H "Content-Type: application/yaml" \
--data-binary @sailops-stack.yaml \
https://app.sailops.io/api/public/api/v1/stack/apply

Exécutez d'abord stack/plan dans les environnements où une revue des changements est nécessaire.

Bonnes pratiques​

  • Utilisez une clé par projet et par environnement.
  • Gardez les clés dans les secrets CI/CD.
  • Déployez des tags immuables, par exemple le SHA Git.
  • Préférez PATCH pour les mises à jour ciblées.
  • Utilisez Stack Engine lorsque plusieurs ressources doivent évoluer ensemble.

Sujets liés​