imgpkg

imgpkg

• Сайт: https://carvel.dev/imgpkg.
• Slack: #carvel в Kubernetes Slack
• Документы с примером рабочего процесса и другими подробностями.
• Установка: скачайте готовые двоичные файлы со страницы «Релизы» или нажмите Homebrew Carvel.
• Отставание: Посмотрите, чем мы занимаемся.

imgpkg (произносится: «пакет изображений») — это инструмент, который позволяет пользователям хранить набор произвольных файлов в виде образа OCI. Одним из наиболее распространенных вариантов использования является хранение конфигурации Kubernetes (обычный YAML, шаблоны ytt, шаблоны Helm и т. д.) в реестре OCI в виде образа.

Основная концепция imgpkg — это пакет, который представляет собой образ OCI, содержащий 0+ произвольных файлов и 0+ ссылок на зависимые образы OCI. Благодаря этой концепции imgpkg может копировать пакеты и зависимые от них образы через реестры (как онлайн, так и оффлайн).

$ imgpkg push -b your-user/app1-config:0.1.1 -f config/
$ imgpkg copy -b your-user/app1-config:0.1.1 --to-repo other-user/app1
$ imgpkg pull -b your-user/app1-config:0.1.1 -o /tmp/app1-config
$ imgpkg tag ls -i your-user/app1-config

Функции:

• Позволяет отправить пакет, содержащий набор файлов и список изображений, от которых они зависят.
• Позволяет извлечь пакет и извлечь тот же набор файлов и список ссылок на изображения.
• Позволяет плотно копировать пакет (т. е. изображение пакета + все изображения, на которые есть ссылки) в репозиторий или архив.
• Поддержка изолированной среды с помощью команды копирования
• Позволяет перечислять теги отправленных изображений.
• Использует тип носителя уровня Docker для работы с существующими реестрами.
• Использует детерминированные права доступа к файлам и временные метки, чтобы сделать изображения воспроизводимыми (тот же дайджест, если ничего не изменилось)

Присоединяйтесь к сообществу и сделайте Carvel лучше

Carvel стал лучше благодаря нашим участникам и сопровождающим. Именно благодаря вам мы можем предложить сообществу отличное программное обеспечение. Пожалуйста, присоединяйтесь к нам во время встреч нашего онлайн-сообщества. Подробности можно найти на нашем сайте Carvel.

Вы можете пообщаться с нами в Kubernetes Slack на канале #carvel и подписаться на нас в Твиттере @carvel_dev.

Узнайте, какие организации используют и вносят свой вклад в Carvel: список последователей.

Разработка

Создайте код с помощью

./hack/build.sh

Тестирование

Запускайте каждый тест с помощью локального реестра (требуется Docker).

./hack/test-all-local-registry.sh 5000

Если вы хотите использовать прокси-реестр для получения изображений, чтобы избежать ограничения скорости со стороны dockerhub, установите для этого прокси переменную среды DOCKERHUB_PROXY, например:

 export DOCKERHUB_PROXY= < my-registry.local.sometld/my-dockerhub-proxy > && ./hack/test-all-local-registry.sh 5000

Изменения исходного кода

Чтобы поддерживать документацию по исходному коду в актуальном состоянии, imgpkg использует godoc. Чтобы документировать тип, переменную, константу, функцию или пакет, напишите обычный комментарий непосредственно перед его объявлением, который начинается с имени описываемого элемента. Пример см. в пакете реестра. При добавлении нового исходного кода через PR линтер GitHub Action гарантирует, что godocs будет включен в изменения.

Чтобы просмотреть документы

1. установите godoc: go install golang.org/x/tools/cmd/godoc@latest
2. Запустите сервер: godoc -http=:6060 и посетите http://localhost:6060/pkg/carvel.dev/imgpkg/ .