共用方式為


服務容器

Azure DevOps Services

如果您的管線需要一或多個服務的支援,您可能需要建立、連線及清除每個作業的服務。 例如,您的管線可能會執行整合測試,這些測試需要存取管線中每個作業的新建立資料庫和記憶體快取。

容器提供簡單且可攜的方式,讓您執行管線相依的服務。 服務容器可讓您自動建立、網路及管理容器化服務的生命週期。 每個服務容器只能存取 需要它的工作 。 服務容器可與任何類型的作業搭配使用,但最常與容器作業搭配使用。

需求

  • 服務容器必須定義 CMDENTRYPOINT。 管線會針對提供的容器執行 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 擷取 nginxbuildpack-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 透過 tcp6379公開 ,系結至主計算機上的隨機埠。

對於系結至主計算機上的隨機埠的埠,管線會建立窗體 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