docker service create

Swarm 此命令適用於 Swarm 編排器。

描述

根據指定引數建立服務。

注意

這是一個叢集管理命令，必須在 Swarm 管理器節點上執行。要了解管理器和工作器，請參閱文件中的Swarm 模式部分。

選項

示例

建立服務

$ docker service create --name redis redis:7.4.1

dmu1ept4cxcfe8k8lhtux3ro3

$ docker service create --mode global --name redis2 redis:7.4.1

a8q9dasaafudfs8q8w32udass

$ docker service ls

ID            NAME    MODE        REPLICAS  IMAGE
dmu1ept4cxcf  redis   replicated  1/1       redis:7.4.1
a8q9dasaafud  redis2  global      1/1       redis:7.4.1

使用私有登錄檔上的映象建立服務（--with-registry-auth）

如果您的映象在需要登入的私有登錄檔上可用，請在登入後使用 `docker service create` 命令時帶上 `--with-registry-auth` 標誌。如果您的映象儲存在私有登錄檔 `registry.example.com` 上，請使用以下命令：

$ docker login registry.example.com

$ docker service  create \
  --with-registry-auth \
  --name my_service \
  registry.example.com/acme/my_image:latest

這會將您本地客戶端的登入令牌透過加密的 WAL 日誌傳遞給部署服務的 Swarm 節點。有了這些資訊，節點就能夠登入登錄檔並拉取映象。

建立具有 5 個副本任務的服務（--replicas）

使用 `--replicas` 標誌為複製服務設定副本任務的數量。以下命令建立一個具有 5 個副本任務的 `redis` 服務：

$ docker service create --name redis --replicas=5 redis:7.4.1

4cdgfyky7ozwh3htjfw0d12qv

上述命令設定了服務的*期望*任務數。儘管命令會立即返回，但服務的實際擴充套件可能需要一些時間。`REPLICAS` 列顯示了服務的實際和期望副本任務數。

在以下示例中，期望狀態是 5 個副本，但當前 RUNNING 任務數為 3：

$ docker service ls

ID            NAME   MODE        REPLICAS  IMAGE
4cdgfyky7ozw  redis  replicated  3/5       redis:7.4.1

一旦所有任務建立並 RUNNING，實際任務數就等於期望任務數。

$ docker service ls

ID            NAME   MODE        REPLICAS  IMAGE
4cdgfyky7ozw  redis  replicated  5/5       redis:7.4.1

建立帶有秘密的服務（--secret）

使用 `--secret` 標誌授予容器訪問 秘密 的許可權。

建立一個指定秘密的服務

$ docker service create --name redis --secret secret.json redis:7.4.1

4cdgfyky7ozwh3htjfw0d12qv

建立一個服務，指定秘密、目標、使用者/組 ID 和模式

$ docker service create --name redis \
    --secret source=ssh-key,target=ssh \
    --secret source=app-key,target=app,uid=1000,gid=1001,mode=0400 \
    redis:7.4.1

4cdgfyky7ozwh3htjfw0d12qv

要授予服務訪問多個秘密的許可權，請使用多個 `--secret` 標誌。

如果未指定目標，則秘密位於容器中的 `/run/secrets`。如果未指定目標，則秘密的名稱用作容器中的記憶體檔案。如果指定了目標，則將其用作檔名。在上面的示例中，為每個指定的秘密目標建立了兩個檔案：`/run/secrets/ssh` 和 `/run/secrets/app`。

建立帶配置的服務（--config）

使用 `--config` 標誌授予容器訪問 配置 的許可權。

建立一個帶有配置的服務。配置將掛載到 `redis-config` 中，由在容器內部執行命令的使用者（通常是 `root`）擁有，檔案模式為 `0444` 或全域性可讀。您可以將 `uid` 和 `gid` 指定為數字 ID 或名稱。使用名稱時，提供的組/使用者名稱稱必須在容器中預先存在。`mode` 指定為 4 位數字序列，例如 `0755`。

$ docker service create --name=redis --config redis-conf redis:7.4.1

建立具有配置的服務並指定目標位置和檔案模式

$ docker service create --name redis \
  --config source=redis-conf,target=/etc/redis/redis.conf,mode=0400 redis:7.4.1

要授予服務訪問多個配置的許可權，請使用多個 `--config` 標誌。

如果未指定目標，則配置位於容器中的 `/`。如果未指定目標，則配置的名稱用作容器中檔案的名稱。如果指定了目標，則將其用作檔名。

建立一個具有滾動更新策略的服務

$ docker service create \
  --replicas 10 \
  --name redis \
  --update-delay 10s \
  --update-parallelism 2 \
  redis:7.4.1

當您執行 服務更新 時，排程程式一次最多更新 2 個任務，每次更新之間間隔 10s。有關更多資訊，請參閱 滾動更新教程。

設定環境變數 (-e, --env)

這將為服務中的所有任務設定環境變數。例如：

$ docker service create \
  --name redis_2 \
  --replicas 5 \
  --env MYVAR=foo \
  redis:7.4.1

要指定多個環境變數，請指定多個 `--env` 標誌，每個標誌帶有一個單獨的鍵值對。

$ docker service create \
  --name redis_2 \
  --replicas 5 \
  --env MYVAR=foo \
  --env MYVAR2=bar \
  redis:7.4.1

建立具有特定主機名的服務 (--hostname)

此選項將 Docker 服務容器的主機名設定為特定字串。例如：

$ docker service create --name redis --hostname myredis redis:7.4.1

為服務設定元資料 (-l, --label)

標籤是一個 `key=value` 對，用於為服務應用元資料。為服務新增兩個標籤：

$ docker service create \
  --name redis_2 \
  --label com.example.foo="bar" \
  --label bar=baz \
  redis:7.4.1

有關標籤的更多資訊，請參閱應用自定義元資料。

新增繫結掛載、卷或記憶體檔案系統 (--mount)

Docker 支援三種不同型別的掛載，允許容器從主機作業系統或記憶體檔案系統讀取或寫入檔案或目錄。這些型別是資料卷（通常簡稱為卷）、繫結掛載、tmpfs 和命名管道。

一個 **繫結掛載** 使主機上的檔案或目錄可供其掛載的容器使用。繫結掛載可以是隻讀或讀寫。例如，容器可以透過繫結掛載主機的 `/etc/resolv.conf` 來共享其主機的 DNS 資訊，或者容器可以將日誌寫入其主機的 `/var/log/myContainerLogs` 目錄。如果您使用繫結掛載，並且您的主機和容器對許可權、訪問控制或其他此類細節有不同的理解，您將遇到可移植性問題。

**命名卷** 是一種機制，用於將容器所需的持久資料與用於建立容器的映象和主機分離。命名卷由 Docker 建立和管理，即使沒有容器當前使用它，命名卷也會持久存在。命名卷中的資料可以在容器和主機之間以及多個容器之間共享。Docker 使用*卷驅動程式*來建立、管理和掛載卷。您可以使用 Docker 命令備份或恢復卷。

一個 **tmpfs** 在容器內掛載一個 tmpfs 用於易失性資料。

一個 **npipe** 將一個命名管道從主機掛載到容器中。

考慮這樣一種情況：您的映象啟動了一個輕量級 Web 伺服器。您可以使用該映象作為基礎映象，複製您的網站 HTML 檔案，並將其打包到另一個映象中。每次您的網站更改時，您都需要更新新映象並重新部署所有為您的網站提供服務的容器。更好的解決方案是將網站儲存在命名卷中，並在 Web 伺服器容器啟動時將其附加到每個容器。要更新網站，只需更新命名卷即可。

有關命名卷的更多資訊，請參閱資料卷。

下表描述了適用於服務中繫結掛載和命名卷的選項：

繫結掛載選項

以下選項只能用於繫結掛載 (type=bind)

繫結傳播

繫結傳播是指在給定繫結掛載或命名卷中建立的掛載是否可以傳播到該掛載的副本。考慮掛載點 `/mnt`，它也掛載在 `/tmp` 上。傳播設定控制 `tmp/a` 上的掛載是否也會在 `/mnt/a` 上可用。每個傳播設定都有一個遞迴的對應點。在遞迴的情況下，考慮 `/tmp/a` 也掛載為 `/foo`。傳播設定控制 `/mnt/a` 和/或 `/tmp/a` 是否存在。

對於繫結掛載和卷掛載，`bind-propagation` 選項預設為 `rprivate`，並且僅可用於繫結掛載。換句話說，命名卷不支援繫結傳播。

• shared：原始掛載的子掛載暴露給副本掛載，副本掛載的子掛載也傳播到原始掛載。
• slave：類似於共享掛載，但只在一個方向上。如果原始掛載暴露了一個子掛載，副本掛載可以看到它。但是，如果副本掛載暴露了一個子掛載，原始掛載無法看到它。
• private：掛載是私有的。其中的子掛載不暴露給副本掛載，副本掛載的子掛載也不暴露給原始掛載。
• rshared：與共享相同，但傳播也延伸到原始掛載點或副本掛載點中巢狀的任何掛載點。
• rslave：與 slave 相同，但傳播也延伸到原始掛載點或副本掛載點中巢狀的任何掛載點。
• rprivate：預設值。與 private 相同，這意味著原始掛載點或副本掛載點內的任何掛載點都不會向任何方向傳播。

有關繫結傳播的更多資訊，請參閱 Linux 核心共享子樹文件。

命名卷的選項

以下選項僅可用於命名卷 (type=volume)

tmpfs 選項

以下選項僅可用於 tmpfs 掛載（type=tmpfs）；

"--mount" 和 "--volume" 之間的區別

--mount 標誌支援 docker run 的 -v 或 --volume 標誌支援的大部分選項，但有一些重要例外：

• --mount 標誌允許您*每個卷*指定卷驅動程式和卷驅動程式選項，而無需提前建立卷。相比之下，docker run 允許您使用 --volume-driver 標誌指定一個由所有卷共享的單個卷驅動程式。

• --mount 標誌允許您在卷建立之前為其指定自定義元資料（“標籤”）。

• 當您將 `type=bind` 與 `--mount` 一起使用時，主機路徑必須指向主機上*現有*的路徑。該路徑不會為您建立，如果路徑不存在，服務將因錯誤而失敗。

• --mount 標誌不允許您使用 Z 或 z 標誌重新標記卷，這些標誌用於 selinux 標記。

建立使用命名卷的服務

以下示例建立一個使用命名卷的服務：

$ docker service create \
  --name my-service \
  --replicas 3 \
  --mount type=volume,source=my-volume,destination=/path/in/container,volume-label="color=red",volume-label="shape=round" \
  nginx:alpine

對於服務的每個副本，引擎會向預設（“local”）卷驅動程式請求一個名為“my-volume”的卷，該卷部署在任務所在的節點上。如果該卷不存在，引擎會建立一個新卷並應用“color”和“shape”標籤。

任務啟動時，該卷會掛載到容器內的 `/path/in/container/`。

請注意，預設的（“local”）卷是一個本地範圍的卷驅動程式。這意味著，根據任務部署的位置，該任務會獲得一個名為“my-volume”的*新*卷，或者與同一服務的其他任務共享同一個“my-volume”。如果容器內執行的軟體未設計為處理併發程序寫入同一位置，則多個容器寫入單個共享卷可能會導致資料損壞。此外，還要考慮到容器可能會被 Swarm 編排器重新排程並部署到不同的節點上。

建立一個使用匿名卷的服務

以下命令建立一個具有三個副本的服務，並在 `/path/in/container` 上使用匿名卷：

$ docker service create \
  --name my-service \
  --replicas 3 \
  --mount type=volume,destination=/path/in/container \
  nginx:alpine

在此示例中，未為卷指定名稱（`source`），因此為每個任務建立了一個新卷。這確保了每個任務都有自己的卷，並且卷不會在任務之間共享。匿名卷在使用它們的任務完成後將被刪除。

建立一個使用繫結掛載的主機目錄的服務

以下示例將主機目錄繫結掛載到服務所支援容器中的 `/path/in/container`：

$ docker service create \
  --name my-service \
  --mount type=bind,source=/path/on/host,destination=/path/in/container \
  nginx:alpine

設定服務模式 (--mode)

服務模式決定這是*複製*服務還是*全域性*服務。複製服務執行指定數量的任務，而全域性服務在 Swarm 中的每個活動節點上執行。

以下命令建立一個全域性服務：

$ docker service create \
 --name redis_2 \
 --mode global \
 redis:7.4.1

指定服務約束（--constraint）

您可以透過定義約束表示式來限制任務可以排程到的節點集。約束表示式可以使用*匹配*（`==`）或*排除*（`!=`）規則。多個約束會找到滿足所有表示式（AND 匹配）的節點。約束可以匹配節點或 Docker Engine 標籤，如下所示：

engine.labels 適用於 Docker Engine 標籤，如作業系統、驅動程式等。Swarm 管理員透過使用 docker node update 命令新增 node.labels 用於操作目的。

例如，以下限制 redis 服務任務到節點型別標籤等於 queue 的節點：

$ docker service create \
  --name redis_2 \
  --constraint node.platform.os==linux \
  --constraint node.labels.type==queue \
  redis:7.4.1

如果服務約束排除了叢集中的所有節點，則會列印一條訊息，表明未找到合適的節點，但排程程式將啟動協調迴圈，並在合適的節點可用時部署服務。

在下面的示例中，未找到滿足約束的節點，導致服務未能與期望狀態協調：

$ docker service create \
  --name web \
  --constraint node.labels.region==east \
  nginx:alpine

lx1wrhhpmbbu0wuk0ybws30bc
overall progress: 0 out of 1 tasks
1/1: no suitable node (scheduling constraints not satisfied on 5 nodes)

$ docker service ls
ID                  NAME     MODE         REPLICAS   IMAGE               PORTS
b6lww17hrr4e        web      replicated   0/1        nginx:alpine

將 region=east 標籤新增到叢集中的節點後，服務會進行協調，並部署所需數量的副本。

$ docker node update --label-add region=east yswe2dm4c5fdgtsrli1e8ya5l
yswe2dm4c5fdgtsrli1e8ya5l

$ docker service ls
ID                  NAME     MODE         REPLICAS   IMAGE               PORTS
b6lww17hrr4e        web      replicated   1/1        nginx:alpine

指定服務放置偏好 (--placement-pref)

您可以將服務設定為將任務均勻地分配到不同類別的節點。其中一個有用的例子是跨資料中心或可用區平衡任務。下面的例子說明了這一點：

$ docker service create \
  --replicas 9 \
  --name redis_2 \
  --placement-pref spread=node.labels.datacenter \
  redis:7.4.1

這使用 `spread` 策略（目前唯一支援的策略）的 `--placement-pref` 選項，將任務均勻地分佈到 `datacenter` 節點標籤的值上。在這個例子中，我們假設每個節點都附加了一個 `datacenter` 節點標籤。如果 Swarm 中的節點有三個不同的 `datacenter` 標籤值，那麼三分之一的任務將放置在與每個值相關聯的節點上。即使一個值比另一個值擁有更多的節點，這也是成立的。例如，考慮以下節點集：

• 三個節點帶有 node.labels.datacenter=east
• 兩個節點帶有 node.labels.datacenter=south
• 一個節點帶有 node.labels.datacenter=west

由於我們正在根據 `datacenter` 標籤的值進行擴充套件，並且服務有 9 個副本，因此每個資料中心將最終分配 3 個副本。有三個節點與值 `east` 相關聯，因此每個節點將獲得為其保留的三個副本中的一個。有兩個節點帶有值 `south`，為其保留的三個副本將在它們之間分配，其中一個節點獲得兩個副本，另一個節點僅獲得一個。最後，`west` 有一個節點，將獲得為其保留的所有三個副本。

如果某個類別中的節點（例如，帶有 `node.labels.datacenter=south` 的節點）由於約束或資源限制而無法處理其公平份額的任務，那麼如果可能，多餘的任務將分配給其他節點。

引擎標籤和節點標籤都受放置偏好支援。上面的示例使用節點標籤，因為該標籤透過 `node.labels.datacenter` 引用。要根據引擎標籤的值進行擴充套件，請使用 ` --placement-pref spread=engine.labels.<labelname>`。

可以向服務新增多個放置偏好。這建立了一個偏好層次結構，因此任務首先在一個類別中劃分，然後進一步劃分為其他類別。一個可能有用的示例是公平地在資料中心之間劃分任務，然後在每個資料中心內將任務分配到機架選擇上。要新增多個放置偏好，請多次指定 `--placement-pref` 標誌。順序很重要，並且在做出排程決策時，放置偏好將按給定的順序應用。

以下示例設定了一個具有多個放置偏好的服務。任務首先分佈在各個資料中心，然後分佈在機架上（由各自的標籤指示）：

$ docker service create \
  --replicas 9 \
  --name redis_2 \
  --placement-pref 'spread=node.labels.datacenter' \
  --placement-pref 'spread=node.labels.rack' \
  redis:7.4.1

當使用 docker service update 更新服務時，--placement-pref-add 會在所有現有放置偏好之後新增一個新的放置偏好。--placement-pref-rm 會刪除與引數匹配的現有放置偏好。

為服務指定記憶體要求和約束（--reserve-memory 和 --limit-memory）

如果您的服務需要最低記憶體才能正常執行，您可以使用 `—reserve-memory` 指定服務只能排程到具有足夠可用記憶體可供保留的節點上。如果沒有滿足條件的節點可用，任務將不會被排程，而是保持掛起狀態。

以下示例要求在將服務排程到特定節點執行之前，該節點上必須有 4GB 記憶體可用且可保留。

$ docker service create --reserve-memory=4GB --name=too-big nginx:alpine

管理員不會將一組容器排程到單個節點上，其總保留量超過該節點上可用的記憶體。

任務排程並執行後，`--reserve-memory` 不強制執行記憶體限制。使用 `--limit-memory` 可確保任務在節點上使用的記憶體不超過給定數量。此示例將任務使用的記憶體量限制為 4GB。即使每個節點只有 2GB 記憶體，任務也會被排程，因為 `--limit-memory` 是一個上限。

$ docker service create --limit-memory=4GB --name=too-big nginx:alpine

使用 `--reserve-memory` 和 `--limit-memory` 並不能保證 Docker 不會比您想要的在主機上使用更多記憶體。例如，您可以建立許多服務，其記憶體使用量總和可能會耗盡可用記憶體。

您可以透過同時考慮在主機上執行的其他（非容器化）軟體來防止這種情況耗盡可用記憶體。如果 `--reserve-memory` 大於或等於 `--limit-memory`，Docker 將不會將服務排程到沒有足夠記憶體的主機上。`--limit-memory` 將限制服務的記憶體以保持在該限制內，因此如果每個服務都設定了記憶體預留和限制，Docker 服務飽和主機的可能性就會降低。在 Docker 主機上直接執行的其他非服務容器或應用程式仍然可能會耗盡記憶體。

這種方法也有缺點。保留記憶體也意味著您可能無法最佳利用節點上可用的記憶體。考慮一個服務，在正常情況下使用 100MB 記憶體，但根據負載可以“峰值”達到 500MB。為該服務保留 500MB（以保證在“峰值”時可以擁有 500MB）會導致大部分時間浪費 400MB 記憶體。

簡而言之，您可以採取更保守或更靈活的方法：

• 保守：保留 500MB，並限制為 500MB。基本上，您現在將服務容器視為虛擬機器，並且您可能會失去容器的一大優勢，即每個主機的服務密度更高。

• 靈活：限制為 500MB，假設如果服務需要超過 500MB，則表示其功能異常。保留介於 100MB“正常”需求和 500MB“峰值”需求之間的一些值。這假設當此服務處於“峰值”時，其他服務或非容器工作負載可能不會處於“峰值”。

您採取的方法很大程度上取決於您的工作負載的記憶體使用模式。您應該在正常和峰值條件下進行測試，然後才能確定一種方法。

在 Linux 上，您還可以使用 `cgroups` 或其他相關的作業系統工具，在主機作業系統級別限制服務在給定主機上的整體記憶體佔用。

指定每個節點的最大副本數 (--replicas-max-per-node)

使用 `--replicas-max-per-node` 標誌可設定可在節點上執行的最大副本任務數。以下命令建立一個 nginx 服務，該服務具有 2 個副本任務，但每個節點僅執行一個副本任務。

一個有用的示例是在資料中心集之間與 `--placement-pref` 一起平衡任務，並讓 `--replicas-max-per-node` 設定確保副本在維護或資料中心故障期間不會遷移到另一個數據中心。

下面的例子說明了這一點：

$ docker service create \
  --name nginx \
  --replicas 2 \
  --replicas-max-per-node 1 \
  --placement-pref 'spread=node.labels.datacenter' \
  nginx

將服務附加到現有網路 (--network)

您可以使用覆蓋網路來連線 swarm 中的一個或多個服務。

首先，在管理節點上使用 docker network create 命令建立一個覆蓋網路：

$ docker network create --driver overlay my-network

etjpu59cykrptrgw0z0hk5snf

在 Swarm 模式下建立覆蓋網路後，所有管理節點都可以訪問該網路。

當您建立服務並傳遞 `--network` 標誌以將服務附加到覆蓋網路時：

$ docker service create \
  --replicas 3 \
  --network my-network \
  --name my-web \
  nginx

716thylsndqma81j6kkkb5aus

Swarm 將 my-network 擴充套件到執行服務的每個節點。

同一網路上的容器可以使用服務發現相互訪問。

--network 的長格式語法允許指定別名列表和驅動程式選項：`--network name=my-network,alias=web1,driver-opt=field1=value1`

將服務埠外部發布到 Swarm (-p, --publish)

您可以使用 `--publish` 標誌將服務埠釋出到 Swarm 外部。`--publish` 標誌可以採用兩種不同風格的引數。短版本是位置性的，允許您指定釋出的埠和目標埠，用冒號（`:`）分隔。

$ docker service create --name my_web --replicas 3 --publish 8080:80 nginx

還有一種長格式，更易於閱讀並允許您指定更多選項。首選長格式。使用短格式時不能指定服務的模式。以下是上面相同服務的長格式示例：

$ docker service create --name my_web --replicas 3 --publish published=8080,target=80 nginx

您可以指定的選項有：

當您使用 `ingress` 模式釋出服務埠時，Swarm 路由網格使服務在每個節點上以釋出的埠可訪問，無論節點上是否有服務任務執行。如果您使用 `host` 模式，則埠僅繫結在執行服務的節點上，並且節點上的給定埠只能繫結一次。您只能使用長語法設定釋出模式。有關更多資訊，請參閱 使用 Swarm 模式路由網格。

為託管服務帳戶提供憑據規範（--credentials-spec）

此選項僅用於使用 Windows 容器的服務。`--credential-spec` 必須採用 `file://` 或 `registry://` 格式。

使用 `file://` 格式時，引用的檔案必須存在於 docker 資料目錄的 `CredentialSpecs` 子目錄中，該目錄在 Windows 上預設為 `C:\ProgramData\Docker\`。例如，指定 `file://spec.json` 將載入 `C:\ProgramData\Docker\CredentialSpecs\spec.json`。

使用 `registry://` 格式時，憑據規範將從守護程式主機上的 Windows 登錄檔中讀取。指定的登錄檔值必須位於

HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Virtualization\Containers\CredentialSpecs

使用模板建立服務

您可以使用 Go 的 text/template 包提供的語法為 service create 的某些標誌使用模板。

支援的標誌如下：

• --hostname
• --mount
• --env

Go 模板的有效佔位符如下所示

模板示例

在此示例中，我們將根據服務的名稱、節點 ID 和主機名設定建立的容器的模板。

$ docker service create \
    --name hosttempl \
    --hostname="{{.Node.Hostname}}-{{.Node.ID}}-{{.Service.Name}}"\
    busybox top

va8ew30grofhjoychbr6iot8c

$ docker service ps va8ew30grofhjoychbr6iot8c

ID            NAME         IMAGE                                                                                   NODE          DESIRED STATE  CURRENT STATE               ERROR  PORTS
wo41w8hg8qan  hosttempl.1  busybox:latest@sha256:29f5d56d12684887bdfa50dcd29fc31eea4aaf4ad3bec43daf19026a7ce69912  2e7a8a9c4da2  Running        Running about a minute ago

$ docker inspect --format="{{.Config.Hostname}}" 2e7a8a9c4da2-wo41w8hg8qanxwjwsg4kxpprj-hosttempl

x3ti0erg11rjpg64m75kej2mz-hosttempl

在 Windows 上指定隔離模式（--isolation）

預設情況下，排程到 Windows 節點上的任務將使用為該特定節點配置的預設隔離模式執行。要強制使用特定的隔離模式，您可以使用 `--isolation` 標誌：

$ docker service create --name myservice --isolation=process microsoft/nanoserver

Windows 上支援的隔離模式有：

• default：使用執行任務的節點上指定的預設設定
• process：使用程序隔離（僅限 Windows Server）
• hyperv：使用 Hyper-V 隔離

建立請求通用資源的服務（--generic-resources）

您可以使用 `--generic-resource` 標誌（如果節點宣傳這些資源）縮小任務可以登陸的節點型別。

$ docker service create \
    --name cuda \
    --generic-resource "NVIDIA-GPU=2" \
    --generic-resource "SSD=1" \
    nvidia/cuda

作為作業執行

作業是一種特殊的服務，旨在執行操作直到完成然後停止，而不是執行長期執行的守護程序。當屬於作業的任務成功退出（返回值為 0）時，該任務被標記為“已完成”，並且不會再次執行。

作業透過兩種模式之一啟動：replicated-job 或 global-job。

$ docker service create --name myjob \
                        --mode replicated-job \
                        bash "true"

此命令將執行一個任務，該任務將使用 `bash` 映象執行 `true` 命令，該命令將返回 0 然後退出。

儘管作業最終是不同型別的服務，但與其他服務相比，它們有一些注意事項：

• 所有更新或回滾配置選項均無效。作業可以更新，但不能推出或回滾，這使得這些配置選項毫無意義。
• 作業在達到 Complete 狀態時絕不會重新啟動。這意味著對於作業，將 --restart-condition 設定為 any 與將其設定為 on-failure 相同。

作業在複製模式和全域性模式下都可用。

複製作業

複製作業類似於複製服務。設定 `--replicas` 標誌將指定要執行的作業迭代總數。

預設情況下，複製作業的所有副本將同時啟動。要控制任何給定時間同時執行的副本總數，可以使用 `--max-concurrent` 標誌：

$ docker service create \
    --name mythrottledjob \
    --mode replicated-job \
    --replicas 10 \
    --max-concurrent 2 \
    bash "true"

上述命令將總共執行 10 個任務，但任何給定時間只會執行其中 2 個。

全域性作業

全域性作業與全域性服務類似，即在每個匹配放置約束的節點上執行一次任務。全域性作業由 `global-job` 模式表示。

請注意，在建立全域性作業後，新增到叢集的任何新節點都將啟動該作業中的一個任務。全域性作業作為一個整體沒有“完成”狀態，除非滿足作業約束的每個節點都有一個已完成的任務。