```{index} docker; registry
```


# Инструкция по подключению к Registry Фабрики Сайтов 

## Порядок взаимодействия Разработчика и Registry Фабрики Сайтов

Для передачи контейнеров от разработчика (подрядчика) на Фабрику Сайтов
достаточно получить через поддержку реквизиты доступа (логин и пароль с правами
push), идентификатор проекта (имя области) и рекомендации. Для этого необходимо
*Менеджеру* или *Владельцу Продукта* написать письмо с запросом на адрес
[sitefactory@appworks.ru](mailto:sitefactory@appworks.ru).

При инициации проекта на Фабрике (размещении сайта) автоматически создаётся
роль "push" и передаётся *Менеджеру Проекта* или *Владельцу Продукта*
вместе с идентификатором проекта или именем области.

В pipeline DevOps трубы разработчику достаточно добавить 2 действия:

- ретег образа(ов) на `release`;
- push образа в registry Фабрики Сайтов.

Ретег образа на `release` является обязательным мероприятием, так как по
процессу приёма только этот тег будет импортироваться и передаваться на
следующую стадию деплоя.

Push должен осуществляться по адресу `release.appworks.ru`. По этому адресу
доступен registry v2. Версия 1 --- не поддерживается.


## Пример использования registry Фабрики Сайтов

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

```bash
docker login release.appworks.ru
```
--- на ввод команды система запросит логин и пароль, выданные поддержкой
Фабрики Сайтов.

```bash
docker tag [ИМЯ ЛОКАЛЬНОГО ОБРАЗА И ТЕГА] \
  release.appworks.ru/[ИМЯ ОБЛАСТИ]/[ОБРАЗ]:release
```
--- команда создаст тег на локальной машине разработчика, но не отправит образ.

```bash
docker push release.appworks.ru/[ИМЯ ОБЛАСТИ]/[ОБРАЗ]:release
```
--- эта команда отправит образ (push в registry) на Фабрику Сайтов.

При выполнении push допустимо заменять имеющийся в registry образ. Это
означает, что система автоочистки ещё не успела сработать.

:[ИМЯ ЛОКАЛЬНОГО ОБРАЗА И ТЕГА]:
  имя образа, задаваемое разработчиком.

:[ИМЯ ОБЛАСТИ]:
  выдаётся поддержкой Фабрики Сайтов по письму, не должно меняться!

:[ОБРАЗ]: 
  задаётся разработчиком, но не должно меняться, если контейнер выполняет ту же
  функцию, что и ранее.


```{important}
После отправки образа необходимо сообщить на адрес
[sitefactory@appworks.ru](mailto:sitefactory@appworks.ru) состав релиза
(перечень изменений), обязательно указав в письме идентификатор проекта.
```