На CoreOS налаштуйте власний реєстр Docker

Ми всі знаємо і любимо Docker, платформу для створення, керування та розподілу контейнерів програм на кількох машинах. Docker Inc. надає послугу для розміщення контейнерів з відкритим кодом для завантаження (або витягування), як репозиторій git, відомий як «Реєстр Docker». Думайте про це як про GitHub для контейнерів Docker.

Але що, якщо ви хочете розмістити свій власний реєстр, відокремлений від загальнодоступного? Що ж, Docker Inc. має відкритий вихідний код своєї програми реєстру на GitHub.

У цьому посібнику ви дізнаєтеся про процес налаштування приватного реєстру Docker за допомогою CoreOS на новому VPS.

CoreOS + Docker

Ми не будемо витрачати багато часу на те, що саме можуть робити Docker і CoreOS, оскільки це виходить за рамки цього підручника. По суті, CoreOS розроблена для масивних кластерів серверів, вона невелика, швидка й автоматично отримує регулярні оновлення безпеки. Його коренева файлова система також доступна лише для читання, що означає, що ви повинні використовувати Docker для запуску будь-якого програмного забезпечення, яке не входить до базової інсталяції.

Це робить Core OS ідеальною хост-системою для Docker!

Витягування та запуск останнього реєстру

Docker Inc. надала реєстр як образ верхнього рівня, це означає, що ми можемо витягнути його вниз за допомогою простого:

docker pull registry

This can take a few minutes depending on the connection speed.

Плюс у тому, що зображення найвищого рівня також означає, що воно отримує регулярну підтримку та оновлення.

Тепер перевіримо реєстр. Ми можемо створити новий контейнер за допомогою образу реєстру:

docker run -p 5000:5000 -d --name=basic_registry registry

Для тих, хто не дуже часто використовував Docker, -pпрапорець означає PORT, що означає, що ми відкриваємо порт 5000 із контейнера на порт хоста 5000.

-dПрапор означає daemon, це призведе до контейнера працювати у фоновому режимі і не друкує висновок на поточну сесію SSH, ми також хочемо , щоб назвати цей базовий тест контейнер , використовуючи --nameопцію , щоб ми могли легко управляти його пізніше.

Переконайтеся, що ваш основний контейнер реєстру запущено за допомогою docker ps. Результат повинен виглядати так:

CONTAINER ID        IMAGE               COMMAND                CREATED             STATUS              PORTS                    NAMES
edfb54e4a8c4        registry:0.8.1      "/bin/sh -c 'exec do   7 seconds ago       Up 6 seconds        0.0.0.0:5000->5000/tcp   basic_registry

Також перейдіть http://YOUR_IP:5000у свій веб-браузер, і ви отримаєте таке повідомлення:

"docker-registry server (dev) (v0.8.1)"

Notice the word dev in the parenthesis. This means that the server is currently running the dev config. We'll look over more configuration soon.

Тепер у вас запущено власний (дуже базовий) реєстр контейнерів! Але ми ще не закінчили.

Можливо, ви хочете зберегти це конфіденційно від сторонніх очей або, можливо, зберігати свої зображення на Amazon S3 замість локального сховища. Давайте розглянемо різні параметри конфігурації в наступному розділі.

Перш ніж ми перейдемо далі, давайте знищимо тестовий контейнер, щоб не наштовхнутися на конфліктні порти.

docker kill basic_registry

Конфігурація реєстру

Є два способи передати конфігурацію до реєстру Docker. Один із способів — це передача змінних середовища до нового контейнера, а інший — додати файл конфігурації.

Ось кілька поширених параметрів конфігурації, які ми будемо використовувати:

• loglevel- Мінімальний обсяг інформації для входу в консоль. За замовчуванням є info.
• standalone– Чи має цей Реєстр діяти самостійно? (Ніколи не запитує публічний реєстр.) За замовчуванням є true.
• index_endpoint- Якщо не автономний, який ще індекс ми будемо запитувати? За замовчуванням index.docker.io.
• cacheі cache_lru- Параметри, що стосуються використання кешу Redis для невеликих файлів, ми торкнемося цього пізніше.
• storage- Який бекенд сховища ми повинні використовувати для цього сервера? (У цьому уроці ми будемо використовувати локальний).
• storage_path - Якщо використовується локальне сховище, який каталог ми маємо використовувати для зберігання файлів?

Перш ніж ми почнемо працювати з конфігурацією, нам потрібен базовий файл для роботи. Файл із репозиторію реєстру Docker на GitHub буде працювати нормально:

wget https://raw.githubusercontent.com/docker/docker-registry/0.8/config/config_sample.yml

Файл має бути успішно збережений з такими результатами, як:

2014-09-14 14:09:01 (156 MB/s) - 'config_sample.yml' saved [5384/5384]

Чудово! Тепер ми можемо змінити цей файл відповідно до наших потреб.

Єдиний текстовий редактор, який постачається з Core OS, — це vim, але не хвилюйтеся, якщо ви ніколи не використовували його раніше, тут буде покроково пояснювати, що редагувати та як це робити.

vim config_sample.yml

Відкривши файл, натисніть Iі в нижньому правому куті відобразиться: -- INSERT --для режиму вставки. Прокрутіть до кінця файлу за допомогою клавіш зі стрілками, ви повинні побачити розділ з позначкою prod.

Ми змінимо два рядки, зміни наведені нижче

prod:
    <<: *local
    storage_path: _env:STORAGE_PATH:/data

Що ми зробили, так це змінили prodконфігурацію, щоб отримати від localрозділу замість s3розділу. Потім ми перезаписали, storage_pathщоб використовувати шлях /dataвсередині нового контейнера.

Після того, як ви підтвердите, що всі зміни правильні, натисніть, ESCщоб вийти з режиму вставки та введіть :wq(це означає записати зміни до файлу та вийти з vim.)

Тепер давайте перейменуємо файл у just config.yml

mv config_sample.yml config.yml

Кешування Redis (необов'язково)

Якщо ви хочете використовувати redis для прискорення роботи реєстру контейнерів, це так само просто, як витягнути новий контейнер із загальнодоступного реєстру та додати ще кілька рядків конфігурації.

Спочатку витягніть зображення верхнього рівня Redis:

docker pull redis

Після успішного витягування образу ми можемо запустити його і назвати його так само, як ми зробили з тестовим реєстром:

docker run -d --name registry-redis redis

Оскільки redis знаходиться в пам’яті, нам не потрібно налаштовувати його, оскільки ми зв’яжемо його з контейнером реєстру на наступних кроках.

Ще раз переконайтеся, що він працює, використовуючи docker ps:

CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
54f65641eccf        redis:2.8           "redis-server"      2 seconds ago       Up 1 seconds        6379/tcp            registry-redis

Тепер знову відкрити config.ymlв vimі ввести режим вставки так само , як в перший раз ми редагували.

Додайте наступні рядки під prodрозділом, переконавшись у правильному відступі. Цього разу ми лише додаємо cacheі cache_lru.

cache:
    host: _env:REDIS_PORT_6379_TCP_ADDR
    port: _env:REDIS_PORT_6379_TCP_PORT
    db: 0

cache_lru:
    host: _env:REDIS_PORT_6379_TCP_ADDR
    port: _env:REDIS_PORT_6379_TCP_PORT
    db: 1

Змінні середовища REDIS_PORT_6379_TCP_ADDRі REDIS_PORT_6379_TCP_PORTпередаються до контейнера реєстру після зв’язування з контейнером Redis.

Тепер ви налаштували контейнер Redis, який працюватиме пліч-о-пліч з контейнером реєстру. Тепер переходимо до створення реєстру!

Побудова контейнера

У нас є всі налаштування та готові, тепер нам потрібно створити фактичний контейнер реєстру.

Запустіть, vim Dockerfileщоб створити новий файл Docker. Увійдіть у режим вставки та дотримуйтеся наведених нижче змін.

FROM registry:latest

# Add the custom configuration file we made 
ADD ./config.yml /docker-registry/config/config.yml

# Create the data directory
RUN mkdir /data

# Set the configuration file to config.yml
env DOCKER_REGISTRY_CONFIG /docker-registry/config/config.yml

# Make sure we use the prod configuration settings 
env SETTINGS_FLAVOR prod

Те, що ми зробили вище, по суті розширили образ реєстру, щоб він використовував наш файл конфігурації та налаштування. Dockerfile — це набір інструкцій для читання та створення Docker. Якщо ви хочете дізнатися більше про файли Docker та їх синтаксис, перегляньте офіційну документацію сайту Docker.

Далі нам потрібно створити контейнер для використання.

docker build -t my_registry .


Sending build context to Docker daemon 13.82 kB
Sending build context to Docker daemon 
Step 0 : FROM registry
 ---> e42d15ec8417
Step 1 : ADD ./config.yml /docker-registry/config/config.yml
 ---> 4339f026d459
Removing intermediate container 2d5138fbcd34
Step 2 : RUN mkdir /data
 ---> Running in a090f0bdbfd1
 ---> 8eb27ba6e12a
Removing intermediate container a090f0bdbfd1
Step 3 : env DOCKER_REGISTRY_CONFIG /docker-registry/config/config.yml
 ---> Running in 565b5bfb2b22
 ---> 914462e46dc0
Removing intermediate container 565b5bfb2b22
Step 4 : env SETTINGS_FLAVOR prod
 ---> Running in 31a92847b851
 ---> b5949575c374
Removing intermediate container 31a92847b851
Successfully built b5949575c374

Тепер ми готові бігти!

Давайте створимо каталог на нашій хост-системі для монтування в контейнер як /dataтом.

mkdir registry-data

Тепер ми можемо розкрутити новий контейнер. Якщо ви плануєте використовувати кеш Redis, скористайтеся другою командою нижче.

# For a non-Redis cache registry
docker run -d -p 5000:5000 -v /home/core/registry-data:/data --name=private_reg my_registry

# For a Redis cached registry (Must have followed Redis Caching section above)
docker run -d -p 5000:5000 -v /home/core/registry-data:/data --name=private_reg --link registry-redis:redis my_registry

Щоб переконатися, що ваш сервер працює правильно, відвідайте http://YOUR_IP:5000. Ви побачите таке повідомлення:

"docker-registry server (prod) (v0.8.1)"

Зверніть увагу, що (prod)означає, що наші зміни в конфігурації були успішними!

Налаштуйте локальний клієнт Docker

Тепер, коли у нас є власний запущений реєстр, ми хочемо, щоб клієнт Docker на наших локальних машинах почав його використовувати. Зазвичай ви використовуєте команду: docker login, але для нашого використання нам потрібно додати ще один аргумент до команди входу:

docker login YOUR_IP:5000

Введіть ім’я користувача та пароль (подумайте про це як створення нового облікового запису) і проігноруйте повідомлення, в якому сказано, що ви повинні активувати його.

Далі давайте витягнемо стокове зображення та перенесемо його до нашого власного сховища.

# Pull the busybox image from the public registry
docker pull busybox

# Tag it with our IP/URL
docker tag busybox YOUR_IP:5000/busybox

# Push it to our newly made registry
docker push YOUR_IP:5000/busybox

Якщо все налаштовано правильно, остаточне повідомлення має бути таким:

Pushing tag for rev [a9eb17255234] on 

Вітаю! Ви налаштували свій власний репозиторій докерів.

Що далі?

Ось кілька ідей щодо того, як покращити ваш новий приватний реєстр:

• Зворотний проксі-сервер за допомогою Nginx або Apache для додаткового захисту, як-от проста автентифікація HTTP.
• Отримайте домен для свого сервера та налаштуйте його, щоб ви могли отримати доступ до свого реєстру за допомогою чогось на кшталт: registry.mysite.com
• Придбайте (або підпишіть) сертифікат SSL, щоб додати ще більше захисту, якщо ваші контейнери містять конфіденційну інформацію.