Documentación Análisis desde tu pipeline de CI
Analiza cada build y para el pipeline cuando aparezca algo grave. El análisis desde CI está incluido a partir del plan Skipper.
Configuración
- Crea un token de acceso en los ajustes de tu cuenta.
- Guárdalo en tu sistema de CI como un secreto llamado SC_TOKEN.
- Añade a tu pipeline los pasos de abajo.
GitHub Actions
- name: Install sc
run: curl -fsSL https://scancontainer.com/install.sh | sh
- name: Scan the image
env:
SC_TOKEN: ${{ secrets.SC_TOKEN }}
run: sc image myapp:${{ github.sha }} --fail-on high
- name: Keep the report
if: always()
env:
SC_TOKEN: ${{ secrets.SC_TOKEN }}
run: sc download last --format pdf --output report.pdf
- uses: actions/upload-artifact@v4
if: always()
with:
name: scan-report
path: report.pdfGitLab CI
scan:
stage: test
script:
- curl -fsSL https://scancontainer.com/install.sh | sh
- sc image myapp:$CI_COMMIT_SHA --fail-on high
after_script:
- sc download last --format pdf --output report.pdf
artifacts:
when: always
paths:
- report.pdfEn GitLab, añade SC_TOKEN como variable enmascarada en los ajustes de CI/CD del proyecto.
Azure DevOps
- script: curl -fsSL https://scancontainer.com/install.sh | sh
displayName: Install sc
- script: sc image myapp:$(Build.BuildId) --fail-on high
displayName: Scan
env:
SC_TOKEN: $(SC_TOKEN)Otros sistemas de CI
Jenkins, CircleCI, Bitbucket Pipelines y los demás funcionan igual: instala sc, define SC_TOKEN y ejecuta el comando de análisis.
Decide cuándo se para el pipeline
| Comando | El pipeline se para cuando |
|---|---|
sc image myapp:1.4 --fail-on critical | Hay un hallazgo crítico. |
sc image myapp:1.4 --fail-on high | Hay un hallazgo alto o crítico. |
sc image myapp:1.4 | Nunca. El análisis solo informa. |
Empieza sin la opción, mira unos cuantos informes y después elige el nivel que tu equipo pueda mantener en verde.
Sin instalar nada
Un docker push desde el pipeline también lanza un análisis. No puede parar el pipeline, porque el resultado llega después de que termine el push.
- name: Log in to scancontainer
run: echo "${{ secrets.SCANCONTAINER_TOKEN }}" | docker login scancontainer.com -u your-user --password-stdin
- name: Scan the image
run: |
docker tag myapp:${{ github.sha }} scancontainer.com/your-user/myapp:${{ github.sha }}
docker push scancontainer.com/your-user/myapp:${{ github.sha }}