跳至內容

Docker

Linux runner 已預備好 Docker,隨時可用。每個 job 都會喺自己嘅虛擬機入面擁有獨立嘅 Docker daemon,而 docker CLI、Buildx 同 Compose 亦已預先安裝。你唔需要執行 setup action,亦唔需要 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 runner 不提供 Docker daemon。如果 job 需要 Docker daemon,請使用 Linux profile。

喺容器入面運行 job#

將 container 指向 job 應該運行嘅映像檔。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-hosted runner 一樣。你可以透過 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

私人註冊表#

喺拉取或推送之前,請使用註冊表專屬嘅登入 action 或 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

對於 job 層級嘅 container,請改為透過 credentials 金鑰傳遞相同嘅憑證,如上例所示。

映像檔拉取#

Docker Hub 嘅拉取請求會透過 Tuist 營運嘅 pull-through cache 提供,因此 job 不會消耗 Docker Hub 嘅匿名速率限制。來自其他註冊表嘅映像檔則會直接拉取。

每個 job 開始時都係一個空嘅映像檔儲存庫,因此你嘅 workflow 所使用嘅映像檔會喺每個 job 中拉取一次,而唔會喺不同 job 之間重用。如果 job 拉取大型自訂映像檔,請盡量保持映像檔細小,或者喺 workflow 中使用帶有快取嘅 Buildx builder 來建構它:

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

如需喺原生 job 或容器 job 中使用持久依賴目錄,請參閱快取卷宗指南。