docker service update

読む時間の目安: 11 分

説明

サービスを更新します。

API 1.24 以上  このコマンドを利用するには、クライアントとデーモンの API はともに、最低でも 1.24 である必要があります。 クライアント上においてdocker versionコマンドを実行して、クライアントとデーモンの API バージョンを確認してください。

Swarm このコマンドは Swarm オーケストレーターにおいて動作します。

利用方法

$ docker service update [オプション] SERVICE

追加説明

指定されたパラメーターによって表されるサービスのアップデートを行います。 このパラメーターは docker service create のものと同じです。 詳しい情報はそこでの説明を参照してください。

サービスへの変更がタスクの再生成を必要とする場合、普通はサービスのアップデートを行うと、それまでのタスクが新たなタスクに置き換わるだけです。 たとえば--update-parallelismの設定を変更しただけであれば、タスクは再生成されません。 個々のタスクはこの設定に影響されないためです。 一方--forceフラグであれば、タスクの再生成が発生します。 このフラグはローリングリスタート（rolling restart）を実施するために用いられるものなので、サービスパラメーターの変更の有無は関係がありません。

メモ

これはクラスター管理コマンドです。 したがって Swarm のマネージャーノード上で実行する必要があります。 マネージャーノードとワーカーノードについては Swarm モード の節を参照してください。

本コマンドの利用例については、以下に示す 利用例の節 を参照してください。

オプション

利用例

サービスのアップデート

$ docker service update --limit-cpu 2 redis

パラメーター変更が不要なローリングアップデート

$ docker service update --force --update-parallelism 1 --update-delay 30s redis

上のコマンド例では--forceフラグを利用することで、サービスタスクがいったん停止した上で、新たなものに置き換わります。 その他のパラメーターではこのようなことは発生しません。 --update-parallelism 1を指定すると、一度に置き換わるタスクはただ 1 つになります（これがデフォルトです）。 --update-delay 30sを指定すると、タスク処理間において 30 秒の遅延を生じさせます。 したがってローリングアップデートは徐々に行われることになります。

マウントの追加と削除

--mount-addまたは--mount-rmオプションは、サービスのバインドマウントやボリュームを追加または削除します。

以下の例では、test-dataボリュームを/somewhereにマウントしたサービスが生成されます。 次の処理によってother-volumeボリュームを/somewhere-elseボリュームにマウントすることも行います。 そして最後にマウントポイント/somewhereをアンマウントします。 こうしてtest-dataボリュームを実際に削除します。 各コマンドでは戻り値としてサービス名が返されます。

• --mount-addフラグは、service createコマンドにおける--mountフラグと同じパラメーターを指定します。 詳しくはコマンドリファレンスservice createの ボリュームとバインドマウント の節を参照してください。

• --mount-rmフラグはマウントのtargetパスを引数に指定します。

$ docker service create \
    --name=myservice \
    --mount type=volume,source=test-data,target=/somewhere \
    nginx:alpine

myservice

$ docker service update \
    --mount-add type=volume,source=other-volume,target=/somewhere-else \
    myservice

myservice

$ docker service update --mount-rm /somewhere myservice

myservice

サービス公開ポートの追加と削除

--publish-addまたは--publish-rmフラグは、サービスの公開ポートを追加または削除します。 docker service create において示しているように、このときには短い文法と長い文法が利用できます。

以下に示す例では、既存のサービスに対して公開ポートを追加します。

$ docker service update \
  --publish-add published=8080,target=80 \
  myservice

ネットワークの追加と削除

--network-addまたは--network-rmフラグは、サービスに対してネットワークを追加または削除します。 docker service create において示しているように、このときには短い文法と長い文法が利用できます。

以下の例では、すでに my-network というネットワークに接続済のサービスに対して、新たにエイリアス名を追加します。

$ docker service update \
  --network-rm my-network \
  --network-add name=my-network,alias=web1 \
  myservice

サービスの前バージョンへのロールバック

--rollbackオプションは、サービスの前バージョンへのロールバックを行います。

このコマンドの実行後は、最後にdocker service updateコマンドを実行した直前の設定状態に戻ります。

以下の例では、サービスのレプリカ数を 4 から 5 に変更します。 その次に元の設定状態にロールバックします。

$ docker service update --replicas=5 web

web

$ docker service ls

ID            NAME  MODE        REPLICAS  IMAGE
80bvrzp6vxf3  web   replicated  0/5       nginx:alpine

webサービスをロールバックします。

$ docker service update --rollback web

web

$ docker service ls

ID            NAME  MODE        REPLICAS  IMAGE
80bvrzp6vxf3  web   replicated  0/4       nginx:alpine

--rollbackオプションでは別のオプションを併用することができます。 たとえば--update-delay 0sを指定すると、タスクごとのロールバック処理を遅延なく実施します。

$ docker service update \
  --rollback \
  --update-delay 0s
  web

web

サービスが更新に失敗したときには、自動的に前バージョンにロールバックするように設定することもできます。 サービスを自動ロールバックするように設定するには--update-failure-action=rollbackを指定します。 タスクの一部に更新に失敗するものが発生した際に、その数が--update-max-failure-ratioにより指定した値を超えた場合には、ロールバック処理が起動します。

ロールバック処理においては発生率、並行処理などに関するパラメーターがあり、以下に示すフラグ値により制御されます。

• --rollback-delay
• --rollback-failure-action
• --rollback-max-failure-ratio
• --rollback-monitor
• --rollback-parallelism

たとえば--update-parallelism 1 --rollback-parallelism 3として設定されたサービスでは、通常のアップデート間隔において一度に 1 つのタスクのみ更新され、ロールバック処理時には 3 つのタスクが同時にロールバックされます。 これらのパラメーターは、自動ロールバック時および--rollbackを指定した手動ロールバック時のいずれにおいても作用します。

Secret の追加と削除

--secret-addおよび--secret-rmオプションは、サービスの Secret（機密情報）の追加または削除を行います。

以下に示す例はssh-2という Secret を追加し、ssh-1という Secret を削除します。

$ docker service update \
    --secret-add source=ssh-2,target=ssh-2 \
    --secret-rm ssh-1 \
    myservice

テンプレート利用によるサービスアップデート

service updateのフラグの中にはテンプレートの利用をサポートするものがあります。 詳しくは service create を参照してください。

分離モードの設定（Windows）

service updateではservice createと同様に--isolationフラグをサポートしています。 その利用方法は service create を参照してください。

ジョブのアップデート

サービスがジョブとして生成されるのは、service createの実行時にサービスモードがreplicated-jobかglobal-jobに設定されたときです。 このときにはサービス更新を行うオプションが制限されます。

ジョブを更新すると、実行中のタスクは即座に停止します。 この処理によってジョブに対する新たなタスクが生成され、各タスクの完了ステータスが初期化されます。 更新処理前に稼働していたタスクは停止され、新たなタスクとして再生成されます。

ジョブはロールアウトやロールバックを行うことはできません。 更新やロールバックを設定する各種設定は、ジョブモードにおいては無効となります。

それまで稼働していたジョブを同一パラメーターにより再起動するには、--forceフラグをつけて更新操作を行います。

上位コマンド

関連コマンド