Деплой Go-серверов с помощью Docker

Введение

На этой неделе команда Docker анонсировала ^[1] официальные базовые образы для Go и других основных языков, предоставляя разработчикам простой и надежный способ создания контейнеров для программ на Go.

В этой статье мы шаг за шагом пройдём создание Docker-контейнера для простого веб-приложения на Go а также деплой этого контейнера в Google Compute Engine. Если вы ещё не знакомы с Docker, вам следует прочесть статью Understanding Docker ^[2], прежде чем читать дальше.

Демо приложение

Для нашего примера мы будем использовать программу outyet ^[3] из репозитория примеров Go ^[4], которая представляет собой простой веб-сервер, который сообщает, была ли выпущена следующая версия Go. Эта программа не имеет зависимостей кроме стандартной библиотеки и не требует никаких дополнительных файлов данных во время выполнения.

Используйте «go get» для загрузки и установки outyet в вашем рабочем окружении:

$ go get github.com/golang/example/outyet

Создаём Dockerfile

Создайте файл с именем Dockerfile в каталоге outyet со следующим содержимым:

# Start from a Debian image with the latest version of Go installed
# and a workspace (GOPATH) configured at /go.
FROM golang

# Copy the local package files to the container's workspace.
ADD . /go/src/github.com/golang/example/outyet

# Build the outyet command inside the container.
# (You may fetch or manage dependencies here,
# either manually or with a tool like "godep".)
RUN go install github.com/golang/example/outyet

# Run the outyet command by default when the container starts.
ENTRYPOINT /go/bin/outyet

# Document that the service listens on port 8080.
EXPOSE 8080

Этот Dockerfile указывает, как собрать контейнер, который будет исполнять outyet, начиная с базовых зависимостей (системы Debian с установленным Go, официального образа golang ^[5]). и заканчивая исходными кодами outyet, его сборкой, и, наконец, запуском.

Шаги ADD, RUN, и ENTRYPOINT являются общими для любого проекта Go. Есть вариант проще: onbuild ^[6] из образа golang, который автоматически копирует исходный код пакета, подгружает зависимости приложения, собирает программу, и настраивает её для запуска при старте.

Если использовать onbuild-вариант, Dockerfile становится гораздо проще:

FROM golang:onbuild
EXPOSE 8080

Сборка и запуск образа

Вызовите docker из каталога приложения чтобы собрать образ из Dockerfile:

$ docker build -t outyet .

При этом будет взят базовый образ golang Docker Hub'a, содержимое приложения будет скопировано в него. Итоговый образ будет помечен тегом outyet.

Чтобы запустить контейнер с созданным образом выполним команду:

$ docker run --publish 6060:8080 --name test --rm outyet

Флаг --publish говорит Docker'у, что необходимо пробросить порт 8080 из контейнера на 6060 в хост-системе.
Флаг --name дает нашему контейнеру указанное имя, чтобы облегчить последующую работу с ним.
Флаг --rm сообщает, что нужно удалить контейнер по завершении его работы.

Запустите контейнер и откройте в браузере адрес localhost ^[7]:6060/. Вы должны увидеть нечто подобное:

(Если Docker запущен на другой машине (или в виртуальной машине), вы должны заменить localhost адресом этой машины. Если вы используете boot2docker на OS X или Windows, вы можете найти этот адрес с помощью boot2docker ip.

Теперь, когда мы убедились, что образ работает, давайте закроем работающий контейнер из другого окна терминала:

$ docker stop test

Создание репозитария в Docker Hub

Docker Hub ^[8], репозитарий контейнеров, из которого мы до этого взяли образ golang, имеет функцию Автоматической сборки ^[9], которая может собирать образ из репозитариев на GitHub или BitBucket.

После коммита Dockerfile'а в репозитарий и создания автоматической сборки для него, любой, у кого установлен Docker, может скачать и запустить наш образ всего одной командой. (Мы увидим насколько это полезно в следующем разделе.)

Чтобы настроить автоматическую сборку, нужно закоммитить Dockerfile в ваш репозитарий на GitHub или BitBucket, создать учетную запись на Docker Hub, и выполнить все инструкции по созданию автоматизированной сборки ^[9].

Когда все будет готово, вы сможете запустить свой контейнер, используя имя автоматизированной сборки:

$ docker run goexample/outyet

(Замените goexample/outyet на имя автоматизированной сборки, которую вы создали)

Развертывание контейнера в Google Compute Engine

Google предоставляет оптимизированные для контейнеров образы Google Compute Engine ^[10], которые позволяют легко поднять виртуальную машину, которая будет работать с произвольным Docker-контейнером. При запуске, запущеная программа читает конфигурационный файл, который определяет, какой контейнер нужно запустить, получает образ контейнера, и запускает его.

Создайте файл containers.yaml ^[11], который определяет, какой Docker-образ нужно запустить и какие порты пробросить:

version: v1beta2
containers:
- name: outyet
  image: goexample/outyet
  ports:
  - name: http
    hostPort: 80
    containerPort: 8080

Обратите внимание, что мы пробрасываем порт контейнера 8080 на внешний 80 порт, порт по умолчанию для обслуживания HTTP трафика. И, опять же, вы должны заменить goexample/outyet на имя вашей автоматической сборки.

Используйте gcloud, чтобы создать экземпляр виртуальной машины для контейнера:

$ gcloud compute instances create outyet 
    --image container-vm-v20140826 
    --image-project google-containers 
    --metadata-from-file google-container-manifest=containers.yaml 
    --tags http-server 
    --zone us-central1-a 
    --machine-type f1-micro

Первый аргумент (outyet) задает имя экземпляра, которое впоследствии будет удобно использовать для административных целей.

Флаги --image и --image-project задают специальный контейнер-оптимизированный образ системы (просто скопируйте эти флаги дословно).
Флаг --metadata-from-file передаёт файл containers.yaml в виртуальную машину.
Флаг --tags помечает экземпляр ВМ как HTTP-сервер, сообщая брандмауэру, что нужно открыть 80 порт.
Флаги --zone и --machine-type флаги указать зону, в которой нужно запустить ВМ и тип машины. (Чтобы увидеть список типов машин и зон, выполните gcloud compute machine-types)

По завершении работы команда gcloud должна вывести информацию о созданном экземпляре. В выводе найдите секцию networkInterfaces, там будет указан IP-адрес экземпляра ВМ. Через пару минут у вас должно получиться открыть этот IP через браузер и увидеть: «Has Go 1.4 been released yet?»

(Чтобы увидеть, что происходит в виртуальной машине, вы можете подключиться к ней по SSH с помощью gcloud compute ssh outyet. Перейдя туда, попробуйте выполнить sudo docker ps чтобы увидеть, какие Docker-контейнеры работают)

Дополнительная информация

То, что мы сделали — только верхушка айсберга и вы можете сделать ещё много со связкой Go, Docker, и Google Compute Engine.

• Чтобы узнать больше о Docker, посмотрите их подробную документацию ^[12].
• Чтобы узнать больше о Docker и Go, взгляните на официальный репозитарий golang в Docker Hub ^[5].
• Чтобы узнать больше о Docker и Google Compute Engine ^[13], посмотрите страницу Container-optimized VM ^[14] и репозитарий google/docker-registry ^[15].

Andrew Gerrand

От переводчика: все замечания по точности перевода, орфографии и стилистике, пожалуйста передавайте через личные сообщения. Буду рад поправить.

Автор: prg

Источник ^[16]