Docker Remote API в Windows и OSX

Существует несколько способов мониторинга контейнеров Docker.

• Docker CLI предоставляет API docker container stats Docker, который предоставляет основную информацию о запущенных контейнерах.
• Docker Remote API предоставляет более подробную информацию о контейнерах.
• Начиная с Docker 1.13, есть экспериментальная функция с конечной точкой Prometheus
• cAdvisor — это инструмент с открытым исходным кодом, который обеспечивает последние характеристики использования контейнера и производительность. Эти данные могут храниться в базе данных временных рядов, такой как InfluxDB. Затем эти данные можно отобразить на графике с использованием панели управления Kibana.

Эти параметры были подробно описаны в предыдущем блоге .

Есть и другие коммерческие опции, такие как Docker EE , Sysdig, Datadog, New Relic, App Dynamics и другие. Если вы работаете с контейнерами в AWS, CloudWatch может обеспечить интегрированный мониторинг.

OSX — моя основная платформа разработки. Но недавно мне понадобился способ мониторинга контейнеров Docker с помощью Remote API (или REST API) на компьютере с Windows. Вывод API REST точно такой же, независимо от операционной системы. Но способ доступа к API-интерфейсу Docker REST с помощью curl отличается на OSX и Windows-машине. В этом блоге объясняется, как именно получить доступ к этому API в этих двух операционных системах.

Ознакомьтесь со спецификацией 1.27 swagger, чтобы узнать больше о возможностях REST API. Более приятную и удобочитаемую версию API можно увидеть с помощью Swagger UI . Это не работает, пока # 32649 не будет исправлено.

Полные подробности о том, как REST API соответствует различным версиям Docker, описаны в Docker REST API Versioning .

Мы углубимся в это чуть позже, но сначала давайте посмотрим, как получить доступ к этому API.

Docker Remote API в OSX

В OSX curl подключается с использованием доменного сокета Unix, как показано ниже:

Контейнер WildFly может быть запущен как:

Статистика может быть получена с помощью команды:

Это начнет печатать статистику как:

Эта статистика обновляется каждую секунду.

Любой другой REST API может быть вызван очень легко с этим. Это просто и понятно.

Установите Docker на Windows

Установка Docker в Windows зависит от вида вашей операционной системы.

Используете ли вы Windows 10+ Pro 64-bit, затем используйте Docker для Windows .

Если вы используете более старую версию Windows, вам нужно использовать Docker Toolbox .

Вы устанавливаете Windows на виртуальной машине? Тогда Virtual Box не может быть использован для создания виртуальной машины. Это связано с тем, что Virtual Box не поддерживает вложенную виртуализацию . Это необходимо, поскольку Docker Toolbox использует Virtual Box для создания и запуска Docker Machine. VMWare Fusion, похоже, здесь работает нормально.

Теперь, когда вы знаете, что необходимо использовать VMWare Fusion, убедитесь, что вы включили вложенную виртуализацию перед запуском виртуальной машины.

Большое спасибо Стефану Шереру ( @stefscherer ) за помощь в понимании деталей конфигурации Windows.

Давайте посмотрим, как теперь можно вызывать REST API Docker.

Docker Remote API в Windows 7/8

В этом разделе показано, как вызвать REST API с помощью curl в Windows 7/8.

API REST может быть вызван с помощью curl как показано ниже:

Прежде всего, REST API, /containers/<name-or-id>/stats , точно такой же. Способ, которым этот API может быть вызван, немного отличается.

Существует четыре различия: первые три параметра указывают учетные данные безопасности для Docker Machine, сгенерированной Docker Toolbox на вашем компьютере с Windows:

• <CERT> — это сертификат SSL для Docker Machine
• <CA_CERT> — это сертификат <CA_CERT> сертификации для Docker Machine
• <KEY> — это ключ, сгенерированный для Docker Machine

Значения этих параметров конфигурации — это значения, сгенерированные интерфейсом командной строки docker-machine .

Последнее изменение заключается в том, что протокол изменяется с http на https .

Вот точная команда, которая работала на Windows 7 VM:

Этот вызов выведет точно такую ​​же статистику, что и на виртуальной машине Windows 7.

Теперь, когда вы знаете, как использовать этот API в OSX и Windows, вы также можете использовать этот API для всего, что делает Docker CLI. Это связано с тем, что Docker CLI — это просто удобная оболочка для REST API. Таким образом, команда docker container run вызывает соответствующий REST API на хосте Docker.

Docker Remote API в Windows 10

Если вы используете Windows 10, используйте Docker для Windows . После этого вам нужно выяснить, какую команду curl нужно использовать. Есть несколько вариантов:

• Используйте оболочку Bash в Windows . Он имеет команду curl которая работает как команда Unix, которую мы все хорошо знаем. В этом случае REST API может быть вызван как:

  1	curl http://localhost:2375/containers/web/stats

  Docker для Windows прослушивает порт 2375 в Windows.

• Если вы пользователь Powershell, установите команду curl как:

  1	choco install -u curl

  Теперь команда для вызова REST API:

  1	curl.exe http://localhost:2375/containers/web/stats

  Обратите внимание, что в Powershell есть псевдоним curl и это псевдоним Invoke-WebRequest . Поэтому обязательно используйте curl.exe для вызова REST API, поскольку эта команда установлена ​​с использованием Chocolatey.

Этот блог предоставил различные варианты вызова API Docker Remote с помощью curl в Windows и OSX.