docker service ls

Список сервисов

Данная команда работает с оркестратором Swarm.

Использование

$ docker service ls [OPTIONS]

Обратитесь к разделу параметров для обзора доступных OPTIONS для этой команды.

Описание

Эта команда выводит список служб, запущенных в swarm.

Примечание

Это команда управления кластером, и её необходимо выполнять на узле менеджера swarm. Чтобы узнать о менеджерах и рабочих, обратитесь к Раздел режима Swarm в документации.

Примеры использования этой команды см. в разделе примеров далее.

Параметры

Имя, сокращенно

По умолчанию

Описание

--filter, -f

Фильтрация выходных данных на основе предоставленных условий

--format

Службы красивой печати с использованием шаблона Go

--quiet, -q

Отображать только идентификаторы

Примеры

На узле менеджера:

$ docker service ls

ID            NAME      MODE            REPLICAS             IMAGE
c8wgl7q4ndfd  frontend  replicated      5/5                  nginx:alpine
dmu1ept4cxcf  redis     replicated      3/3                  redis:3.0.6
iwe3278osahj  mongo     global          7/7                  mongo:3.3
hh08h9uu8uwr  job       replicated-job  1/1 (3/5 completed)  nginx:latest

Столбец REPLICAS показывает как фактическое, так и желаемое количество задач для службы. Если служба находится в replicated-job или global-job , она дополнительно покажет состояние завершения задания как выполненные задачи по сравнению с общим количеством задач, которые будет выполнять задание.

Фильтрация

Флаг фильтрации ( -f или --filter ) имеет формат «ключ=значение». Если имеется более одного фильтра, передать несколько флагов (например, --filter "foo=bar" --filter "bif=baz")

В настоящее время поддерживаются следующие фильтры:

  • идентификатор

  • этикетка

  • mode

  • name

идентификатор

Фильтр id соответствует полному или частичному идентификатору службы.

$ docker service ls -f "id=0bcjw"
ID            NAME   MODE        REPLICAS  IMAGE
0bcjwfh8ychr  redis  replicated  1/1       redis:3.0.6

этикетка

Фильтр label сопоставляет службы на основе наличия одного label или label и значения.

Следующий фильтр сопоставляет все службы с меткой project независимо от её значения:

$ docker service ls --filter label=project
ID            NAME       MODE        REPLICAS  IMAGE
01sl1rp6nj5u  frontend2  replicated  1/1       nginx:alpine
36xvvwwauej0  frontend   replicated  5/5       nginx:alpine
74nzcxxjv6fq  backend    replicated  3/3       redis:3.0.6

Следующий фильтр сопоставляет только службы с меткой project со значением project-a.

$ docker service ls --filter label=project=project-a
ID            NAME      MODE        REPLICAS  IMAGE
36xvvwwauej0  frontend  replicated  5/5       nginx:alpine
74nzcxxjv6fq  backend   replicated  3/3       redis:3.0.6

mode

Фильтр mode соответствует режиму (replicated или global) службы.

Следующий фильтр соответствует только службам global.

$ docker service ls --filter mode=global
ID                  NAME                MODE                REPLICAS            IMAGE
w7y0v2yrn620        top                 global              1/1                 busybox

name

Фильтр name соответствует полному имени службы или его части.

Следующий фильтр сопоставляет службы с именем, содержащим redis .

$ docker service ls --filter name=redis
ID            NAME   MODE        REPLICAS  IMAGE
0bcjwfh8ychr  redis  replicated  1/1       redis:3.0.6

Форматирование

Параметры форматирования ( --format ) отображают выходные данные служб с использованием шаблона Go.

Допустимые заполнители для шаблона Go перечислены далее:

Заполнитель

Описание

.ID

Идентификатор службы

.Name

Наименование сервиса

.Mode

Сервисный режим (реплицированный, глобальный)

.Replicas

Сервисные реплики

.Image

Образ службы

.Ports

Сервисные порты опубликованы в режиме входа

При использовании параметра --format команда service ls либо выводит данные точно так, как декларирует шаблон, либо, при использовании директивы table, также включает заголовки столбцов.

В следующем примере используется шаблон без заголовков и выводятся записи ID , Mode и Replicas , разделенные двоеточием ( : ) для всех служб:

$ docker service ls --format "{{.ID}}: {{.Mode}} {{.Replicas}}"

0zmvwuiu3vue: replicated 10/10
fm6uf97exkul: global 5/5

Родительская команда

Команда

Описание

docker сервис

Управление службами