Методы для работы с Docker registry

См.также

Актуальная спецификация (автодокументация по методам).

Описание методов

Метод API	HTTP-метод	Описание
Current registry	GET	Получение информации о регистри текущего воркспейса.
Repositories	GET	Показывает репозитории которые есть.
Repositories	DELETE	Удаление репозитория.
Repository	GET	Получение информации о репозитории.
Repository	PUT	Добавить лейбл, добавить описание.
Repository fav	POST	Добавить репозиторий в избранное.
Images	GET	Получить список образов для конкретного репозитория.
Images	DELETE	Удалить образ.
Image	GET	Получить образ.
Tags	GET	Получить тег конкретного образа.
Tags	POST	Добавить тег к образу.
Tags	DELETE	Удалить тег образа.
Tag	PUT	Обновить тег образа.

Подробнее см. в спецификации.

Сценарий использования методов для работы с Docker registry

1. Аутентификация в Docker registry с помощью метода GET public/v2/docker_registry/v1/users/generate_password.

2. Тегирование образа с помощью метода POST public/v2/docker_registry/v2/tags/. В теле запроса должен быть передан идентификатор образа image_id, для которого создается тэг, имя образа name и цвет color.

   {
     "image_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
     "name": "string",
     "color": "string"
   }
   

3. Загрузка образа в Docker registry.

   См.также

   Базовые действия по работе с образами

4. Чтение списка репозиториев в Docker registry с помощью методов:

   • GET public/v2/docker_registry/v2/repositories/ — возвращает список репозиториев в докер Docker registry.

   • GET public/v2/docker_registry/v2/registries/current — возвращает информацию по Docker registry, привязанному к текущему воркспейсу.

   • GET public/v2/docker_registry/v2/repositories/{repository_id}, — возвращает информацию по конкретному репозиторию. В адресе передается repository_id.

5. Добавление репозитория в избранное

   POST public/v2/docker_registry/v2/repositories/{repository_id}/fav. Добавляет репозиторий в избранное, пример тела запроса:

   {"favorite": true/false}
   

6. Чтение конкретного репозитория. Метод возвращает список образов в конкретном репозитории.

   GET public/v2/docker_registry/v2/images/?repository_id={repository_id}.

7. Изменение репозитория.

   PUT public/v2/docker_registry/v2/repositories/{repository_id}

8. Чтение образов в репозитории. Метод возвращает информацию по конкретному образу.

   GET public/v2/docker_registry/v2/images/»image_id».

9. Чтение тега для образа. Метод возвращает информацию по тэгам у конкретного образа.

   GET public/v2/docker_registry/v2/tags/?image_id=44b5e14a-3919-11ea-8f8f-3a4ce9d1e497.

10. Создание нового тега.

    POST public/v2/docker_registry/v2/tags/.

    {
      "image_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "color": "string"
    }
    

11. Изменение тега

    PUT public/v2/docker_registry/v2/tags/{tag_id}. В адресе запроса нужно передать tag_id, для которого производятся изменения. Метода меняет цвет тэга, в теле передается новое значение.

    {
      "color": "string"
    }
    

12. Удаление тега. Метод удаляет тег образа из репозитория, в теле передается id удаляемого образа image_id.

    DELETE public/v2/docker_registry/v2/tags/.

    {
      "tag_ids": [
        "3fa85f64-5717-4562-b3fc-2c963f66afa6"
      ]
    }
    

13. Удаление образа.

    DELETE public/v2/docker_registry/v2/images/.

    {
     "image_ids": [
       "3fa85f64-5717-4562-b3fc-2c963f66afa6"
     ]
    }
    

14. Удаление репозитория. В теле передается id репозитория

    DELETE public/v2/docker_registry/v2/repositories/.

    {
    "repository_ids": [
        "3fa85f64-5717-4562-b3fc-2c963f66afa6"
      ]
    }