Docker
Linux 執行器已預先安裝 Docker,開箱即用。每個工作都會在虛擬機器內獲得專屬的 Docker daemon,且已預先安裝 docker CLI、Buildx 與 Compose。你不需要執行設定動作,也無需使用 sudo。
yaml
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
僅限 Linux
macOS 執行器不提供 Docker daemon。若工作需要 Docker,請使用 Linux 設定檔。
在容器中執行工作#
將 container 指向工作應執行的映像檔。Tuist 會拉取該映像檔,並在其中執行每個步驟:
yaml
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
服務容器#
services 的運作方式與 GitHub 託管執行器相同。服務可透過對應的連接埠在 localhost 上存取:
yaml
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
私人註冊表#
在拉取或推送之前,請使用註冊表專屬的登入動作或 docker login 進行驗證:
yaml
- 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
若是工作層級的 container,請改為透過 credentials 金鑰傳遞相同的憑證,如上例所示。
映像檔拉取#
Docker Hub 的拉取請求會經由 Tuist 營運的直通快取提供,因此工作不會消耗 Docker Hub 的匿名速率限制。來自其他註冊表的映像檔則會直接拉取。
每個工作開始時映像檔儲存區都是空的,因此工作流程使用的映像檔會在每個工作中各拉取一次,而非跨工作重複使用。如果工作需要拉取大型自訂映像檔,請盡量縮小映像檔大小,或在工作流程中使用已快取的 Buildx 建構器來建置:
yaml
- 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
若要在原生工作或容器工作中使用持久的相依性目錄,請參閱快取磁碟區指南。