Intégration CI/CD
SailOps prend en charge deux approches pour automatiser les déploiements :
| Approche | Usage recommandé | Fonctionnement |
|---|---|---|
| Appels API directs | Mise à jour simple d'image ou redémarrage | Appeler des endpoints comme PATCH /containers/{name} |
| Stack Engine | Gestion complète d'infrastructure | Appliquer 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
PATCHpour les mises à jour ciblées. - Utilisez Stack Engine lorsque plusieurs ressources doivent évoluer ensemble.