服務容器
Azure DevOps Services
如果您的管線需要一或多個服務的支援，您可能需要建立、連線及清除每個作業的服務。 例如，您的管線可能會執行整合測試，這些測試需要存取管線中每個作業的新建立資料庫和記憶體快取。
容器提供簡單且可攜的方式，讓您執行管線相依的服務。 服務容器可讓您自動建立、網路及管理容器化服務的生命週期。 每個服務容器只能存取 需要它的工作 。 服務容器可與任何類型的作業搭配使用，但最常與容器作業搭配使用。
需求
服務容器必須定義
CMD或ENTRYPOINT。 管線會針對提供的容器執行docker run，而不需要任何自變數。Azure Pipelines 可以執行 Linux 或 Windows 容器。 您可以使用適用於 Linux 容器的託管 Ubuntu 容器集區或適用於 Windows 容器的託管 Windows 集區。 裝載的 macOS 集區不支援執行容器。
注意
傳統管線不支援服務容器。
單一容器作業
下列範例 YAML 管線定義會顯示單一容器作業。
resources:
containers:
- container: my_container
image: buildpack-deps:focal
- container: nginx
image: nginx
pool:
vmImage: 'ubuntu-latest'
container: my_container
services:
nginx: nginx
steps:
- script: |
curl nginx
displayName: Show that nginx is running
上述管線會從 Docker Hub 擷取 nginx 和 buildpack-deps 容器，然後啟動容器。 容器會一起建立網路，以便依名稱 services 彼此連線。
從此作業容器內部， nginx 主機名會使用 Docker 網路解析為正確的服務。 網路上的所有容器都會自動向彼此公開所有埠。
單一非容器作業
您也可以使用不含作業容器的服務容器，如下列範例所示。
resources:
containers:
- container: nginx
image: nginx
ports:
- 8080:80
env:
NGINX_PORT: 80
- container: redis
image: redis
ports:
- 6379
pool:
vmImage: 'ubuntu-latest'
services:
nginx: nginx
redis: redis
steps:
- script: |
curl localhost:8080
echo $AGENT_SERVICES_REDIS_PORTS_6379
上述管線會啟動最新的 nginx 容器。 由於作業未在容器中執行，因此沒有自動名稱解析。 相反地，您可以使用 來聯機服務 localhost。 此範例會明確提供 8080:80 埠。
替代方法是讓隨機埠在運行時間動態指派。 您接著可以使用變數來存取這些動態埠。 這些變數的格式如下： agent.services.<serviceName>.ports.<port>。 在Bash腳稿中，您可以使用進程環境來存取變數。
在上述範例中， redis 會指派主機上的隨機可用埠。 變數 agent.services.redis.ports.6379 包含埠號碼。
多個作業
針對相同服務的多個版本執行相同步驟，服務容器也很有用。 在下列範例中，相同的步驟會針對多個 PostgreSQL 版本執行。
resources:
containers:
- container: my_container
image: ubuntu:22.04
- container: pg15
image: postgres:15
- container: pg14
image: postgres:14
pool:
vmImage: 'ubuntu-latest'
strategy:
matrix:
postgres15:
postgresService: pg15
postgres14:
postgresService: pg14
container: my_container
services:
postgres: $[ variables['postgresService'] ]
steps:
- script: printenv
連接埠
當您叫用容器資源或內嵌容器時，可以指定要在容器上公開的陣列 ports ，如下列範例所示。
resources:
containers:
- container: my_service
image: my_service:latest
ports:
- 8080:80
- 5432
services:
redis:
image: redis
ports:
- 6379/tcp
ports如果您的作業在容器中執行，則不需要指定 ，因為相同 Docker 網路上的容器預設會自動向彼此公開所有埠。
如果您的作業在主機上執行， ports 則需要存取服務。 埠會採用表單 <hostPort>:<containerPort> ，或只是 <containerPort> 結尾的選擇性 /<protocol> 。 例如， 6379/tcp 透過 tcp 埠 6379公開 ，系結至主計算機上的隨機埠。
對於系結至主計算機上的隨機埠的埠，管線會建立窗體 agent.services.<serviceName>.ports.<port> 的變數，讓作業可以存取埠。 例如， agent.services.redis.ports.6379 解析為主計算機上的隨機指派埠。
磁碟區
磁碟區適用於在服務之間共享數據，或用於在作業的多個執行之間保存數據。 您可以將磁碟區掛接指定為 格式的陣列volumes，其中 <source> 可以是主計算機上的具名磁碟區或絕對路徑，而且<destinationPath>是容器中的絕對<source>:<destinationPath>路徑。 磁碟區可以命名為 Docker 磁碟區、匿名 Docker 磁碟區，或系結裝載在主機上。
services:
my_service:
image: myservice:latest
volumes:
- mydockervolume:/data/dir
- /data/dir
- /src/dir:/dst/dir
注意
如果您使用Microsoft裝載集區，您的磁碟區不會在作業之間保存，因為每個作業完成後都會清除主計算機。
啟動選項
服務容器與容器作業共用相同的容器資源。 這表示您可以使用相同的 啟動選項。
健康情況檢查
如果有任何服務容器指定 HEALTHCHECK，代理程式可以選擇性地等到容器狀況良好，再執行作業。
具有服務範例的多個容器
下列範例包含連線至 PostgreSQL 和 MySQL 資料庫容器的 Django Python Web 容器。
- PostgreSQL 資料庫是主資料庫，其容器名為
db。 - 容器
db會使用磁碟區/data/db:/var/lib/postgresql/data，而且有三個資料庫變數會透過env傳遞至容器。 - 容器
mysql會使用埠3306:3306，而且也有透過env傳遞的資料庫變數。 - 容器
web會以埠8000開啟。
在步驟中， pip 安裝相依性，然後執行 Django 測試。
若要設定工作範例，您需要以兩個 資料庫設定 Django 網站。 此範例假設您的 manage.py 檔案位於根目錄中，而 Django 專案也位於該目錄中。 如果沒有，您可能需要更新 /__w/1/s/ 中的 /__w/1/s/manage.py test路徑。
resources:
containers:
- container: db
image: postgres
volumes:
- '/data/db:/var/lib/postgresql/data'
env:
POSTGRES_DB: postgres
POSTGRES_USER: postgres
POSTGRES_PASSWORD: postgres
- container: mysql
image: 'mysql:5.7'
ports:
- '3306:3306'
env:
MYSQL_DATABASE: users
MYSQL_USER: mysql
MYSQL_PASSWORD: mysql
MYSQL_ROOT_PASSWORD: mysql
- container: web
image: python
volumes:
- '/code'
ports:
- '8000:8000'
pool:
vmImage: 'ubuntu-latest'
container: web
services:
db: db
mysql: mysql
steps:
- script: |
pip install django
pip install psycopg2
pip install mysqlclient
displayName: set up django
- script: |
python /__w/1/s/manage.py test