Docker
Los runners de Linux incluyen Docker listo para usar. Cada trabajo obtiene su propio demonio de Docker dentro de la máquina virtual del trabajo, y el CLI de docker, Buildx y Compose vienen preinstalados. No necesitas una acción de configuración ni sudo.
jobs:
build:
runs-on: tuist-linux
steps:
- uses: actions/checkout@v4
- run: docker build -t my-app .
- run: docker run --rm my-app ./run-checks.sh
Los runners de macOS no proporcionan un demonio de Docker. Usa un perfil de Linux para los trabajos que lo necesiten.
Ejecutar un trabajo en un contenedor#
Apunta container a la imagen en la que debe ejecutarse tu trabajo. Tuist la descarga y ejecuta cada paso dentro de ella:
jobs:
test:
runs-on: tuist-linux
container:
image: ghcr.io/my-org/android-ci:latest
credentials:
username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }}
steps:
- uses: actions/checkout@v4
- run: ./gradlew test
Contenedores de servicio#
services funciona igual que en los runners alojados en GitHub. Los servicios son accesibles en localhost en sus puertos asignados:
jobs:
test:
runs-on: tuist-linux
services:
postgres:
image: postgres:16
env:
POSTGRES_PASSWORD: postgres
ports:
- 5432:5432
steps:
- uses: actions/checkout@v4
- run: mix test
Registros privados#
Autentícate con la acción de inicio de sesión del propio registro o con docker login antes de hacer pull o push:
- uses: docker/login-action@v3
with:
registry: ghcr.io
username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }}
- run: docker pull ghcr.io/my-org/android-ci:latest
Para un container a nivel de trabajo, pasa las mismas credenciales a través de la clave credentials, como en el ejemplo anterior.
Descargas de imágenes#
Las descargas desde Docker Hub se sirven a través de una caché pull-through operada por Tuist, por lo que los trabajos no consumen el límite anónimo de tasa de Docker Hub. Las imágenes de otros registros se descargan directamente.
Cada trabajo comienza con un almacén de imágenes vacío, por lo que una imagen que usa tu flujo de trabajo se descarga una vez por trabajo en lugar de reutilizarse entre trabajos. Si un trabajo descarga una imagen personalizada grande, mantén la imagen pequeña o constrúyela en el flujo de trabajo con un builder de Buildx con caché:
- uses: docker/setup-buildx-action@v3
- uses: docker/build-push-action@v6
with:
context: .
tags: my-app:latest
load: true
cache-from: type=gha
cache-to: type=gha,mode=max
Para directorios de dependencias persistentes en trabajos nativos o en contenedores, consulta la guía de volúmenes de caché.