Методы для работы с 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 с помощью методов:

  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"
      ]
    }