Скачать Go-модуль из реестра Cloud Registry

Для скачивания Go-модуля необходима роль cloud-registry.artifacts.puller или выше.

Загрузка Go-модулей выполняется штатной командой go — реестр Cloud Registry работает как Go-прокси и реализует Module Proxy Protocol.

Настройка окруженияНастройка окружения

1. Укажите реестр как прокси Go-модулей и отключите проверку контрольных сумм через публичную Go checksum database для Go-модулей из вашего реестра:

   export GOPROXY=https://registry.yandexcloud.net/go/<идентификатор_реестра>,https://proxy.golang.org,direct
   export GONOSUMDB=registry.yandexcloud.net/*
   

   Где:

   • GOPROXY — список Go-прокси через запятую. Команда go ищет Go-модуль последовательно в каждом источнике:
     • https://registry.yandexcloud.net/go/<идентификатор_реестра> — ваш реестр Cloud Registry;
     • https://proxy.golang.org — публичный Go-прокси для модулей из открытых репозиториев;
     • direct — прямое обращение к VCS-репозиторию (например, GitHub), если Go-модуль не найден ни в одном из прокси.
   • GONOSUMDB — шаблоны путей Go-модулей, для которых пропускается проверка контрольных сумм.

2. Передайте учетные данные для аутентификации в реестре. Команда go поддерживает только Basic-аутентификацию, рекомендуемый способ передачи учетных данных — файл ~/.netrc.

   IAM-токен

   API-ключ

   Добавьте в файл ~/.netrc строку:

   machine registry.yandexcloud.net login iam password <IAM-токен>
   

   Добавьте в файл ~/.netrc строку:

   machine registry.yandexcloud.net login api_key password <API-ключ>
   

   Примечание

   Файл ~/.netrc должен быть доступен на чтение только владельцу. Установите права доступа:

   chmod 600 ~/.netrc
   

Добавление Go-модуля в проектДобавление Go-модуля в проект

1. Перейдите в корень Go-проекта, в котором находится файл go.mod.

2. Добавьте Go-модуль нужной версии:

   go get registry.yandexcloud.net/go/<идентификатор_реестра>/<имя_модуля>@<версия>
   

   Например:

   go get registry.yandexcloud.net/go/e5o6a2blpkb6********/mymodule@v1.0.0
   

   Команда скачает Go-модуль в локальный кеш и добавит запись о нем в go.mod и go.sum:

   go: added registry.yandexcloud.net/go/e5o6a2blpkb6********/mymodule v1.0.0
   

3. (Опционально) Если Go-модуль уже используется в коде через директиву import, синхронизируйте go.mod и go.sum:

   go mod tidy
   

4. (Опционально) Скачайте все зависимости проекта в локальный кеш без сборки:

   go mod download
   

Полезные ссылкиПолезные ссылки

• Загрузить Go-модуль в реестр
• Создать Go-модуль