imgpkg

ウェブサイト: https://carvel.dev/imgpkg
Slack: Kubernetes Slack の #carvel
ワークフローの例とその他の詳細が記載されたドキュメント
インストール: リリースページまたは Homebrew Carvel タップから事前に構築されたバイナリを取得します。
バックログ: 私たちの取り組みをご覧ください。

imgpkg (「イメージパッケージ」と発音) は、ユーザーが任意のファイルのセットを OCI イメージとして保存できるツールです。主要なユースケースの 1 つは、Kubernetes 構成 (プレーン YAML、ytt テンプレート、Helm テンプレートなど) をイメージとして OCI レジストリに保存することです。

imgpkg の主な概念はバンドルです。これは、0 個以上の任意のファイルと、依存する OCI イメージへの 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

特徴：

ファイルのセットと、それらが依存するイメージのリストを含むバンドルをプッシュできます。
バンドルをプルし、同じファイルのセットとイメージ参照のリストを抽出できます。
バンドル (つまり、バンドルイメージ + すべての参照イメージ) をリポジトリまたは tarball にコピーできます。
コピーコマンドによるエアギャップ環境のサポート
プッシュされたイメージタグをリストできるようにします
Docker レイヤーのメディアタイプを使用して既存のレジストリを操作します
確定的なファイル権限とタイムスタンプを使用して画像を再現可能にします（何も変更されていなければ同じダイジェスト）

コミュニティに参加して Carvel をより良いものにしましょう

Carvel がより優れているのは、貢献者とメンテナーのおかげです。皆さんのおかげで、私たちは素晴らしいソフトウェアをコミュニティに提供することができます。オンラインコミュニティミーティングにぜひご参加ください。詳細はカーベルのウェブサイトでご覧いただけます。

Kubernetes Slack の #carvel チャンネルでチャットしたり、Twitter で @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 リンターは godoc が変更に含まれていることを確認します。

ドキュメントを表示するには

godoc をインストール: go install golang.org/x/tools/cmd/godoc@latest
サーバーを起動します: godoc -http=:6060 、 http://localhost:6060/pkg/carvel.dev/imgpkg/にアクセスします。

拡大する

追加情報