IK.AM

@making's tech note

Carvel kbldでコンテナイメージをair-gapped環境にrelocateする

🗃 {Dev/Carvel/kbld}
🏷 Kubernetes 🏷 Carvle 🏷 air-gapped 🏷 kbld 
🗓 Updated at 2021-12-12T15:00:00Z  🗓 Created at 2021-12-12T15:00:00Z   🌎 English Page

TUNA-JP Advent Calendar 2021 その2の13日目のエントリです。

Carvel の kbld は manifest中のimageに設定されているイメージ名をdigest付きのイメージ名に変換します。 また、この時に変換のマッピングファイルを吐くことにより、簡単にrelocation (別のコンテナレジストリへの引越し) を実現できます。

kbldを使わない場合、

docker pull <移行元のイメージ名>
docker tag <移行元のイメージ名> <移行先イメージ名>
docker push <移行先イメージ名>
sed -i 's/<移行元のイメージ名>/<移行先イメージ名>/g'

を使用するイメージの数だけ実行しないといけません。また、移行先がair-gapped環境(インターネットに繋がっていない環境)の場合は、dockerイメージを一度tarにexportしてからUSBメモリなどに書き出して移動する必要があります。

kbldはair-gapped環境へのrelocationにも対応しているので、インターネットに繋がっていない環境でk8sを扱わないといけない方にはかなり重宝するツールです。

基本的は こちらのドキュメント の通りです。

目次

kbldのインストール

Macの場合、brewでインストールできます。

brew tap vmware-tanzu/carvel
brew install kbld

他の環境では https://github.com/vmware-tanzu/carvel-kbld/releases からバイナリをダウンロードし、/usr/local/bin などにインストールしてください。

kbld含むCarvelのツールを一式インストールしたい場合は、次のコマンドでインストールできます。

wget -O- https://carvel.dev/install.sh | bash
# or with curl...
curl -L https://carvel.dev/install.sh | bash

次のバージョンで動作確認しています。

$ kbld version
kbld version 0.31.0

guestbookのrelocation

サンプルアプリとして guestbook をrelocateしてみます。まずはmanifestをダウンロードします。

mkdir -p guestbook/config
cd guestbook/config
wget https://github.com/kubernetes/website/raw/main/content/en/examples/application/guestbook/frontend-deployment.yaml
wget https://github.com/kubernetes/website/raw/main/content/en/examples/application/guestbook/frontend-service.yaml
wget https://github.com/kubernetes/website/raw/main/content/en/examples/application/guestbook/redis-follower-deployment.yaml
wget https://github.com/kubernetes/website/raw/main/content/en/examples/application/guestbook/redis-follower-service.yaml
wget https://github.com/kubernetes/website/raw/main/content/en/examples/application/guestbook/redis-leader-deployment.yaml
wget https://github.com/kubernetes/website/raw/main/content/en/examples/application/guestbook/redis-leader-service.yaml
cd ..

次のコマンドを実行し、manifest中のimageをdigestでlockするためのファイルを生成します。

kbld -f config --lock-output images.lock

生成されたimages.lockは次の内容です。3つのイメージ(redis, gb-frontend, gb-redis-follower)のdigestが出力されていることがわかります。

apiVersion: kbld.k14s.io/v1alpha1
kind: Config
minimumRequiredVersion: 0.31.0
overrides:
- image: docker.io/redis:6.0.5
  newImage: index.docker.io/library/redis@sha256:800f2587bf3376cb01e6307afe599ddce9439deafbd4fb8562829da96085c9c5
  preresolved: true
- image: gcr.io/google_samples/gb-frontend:v5
  newImage: gcr.io/google_samples/gb-frontend@sha256:dc8de8e0d569d2f828b187528c9317bd6b605c273ac5a282aebe471f630420fc
  preresolved: true
- image: gcr.io/google_samples/gb-redis-follower:v2
  newImage: gcr.io/google_samples/gb-redis-follower@sha256:42707dbdccb4c8177523e2687c7b3cdb3d13473b0df1d3ef2c558fda09772c6f
  preresolved: true

relocationとは関係ありませんが、このlockファイルを使って、次のコマンドを実行すると、イメージ名がdigest付きのものに変換されたmanifestが出力され、常に同じイメージを使用するimmutableなmanifestとして利用できます。

kbld -f config -f images.lock

さて、このlockファイルを使用することでimageのrelocationも行えます。

移行元のコンテナレジストリから移行先のコンテナレジストリへ直接relocationする方法と中間のtarファイルを経由する方法があります。

以下では移行先のコンテナレジストリとして こちらの記事 で利用したHarborを使用します。 air-gappedな環境からこのHarborへアクセスすることができる前提です。

移行元のコンテナレジストリから移行先のコンテナレジストリへ直接relocation

操作端末が移行元のコンテナレジストリと移行先のコンテナレジストリの両方にアクセスできる場合、直接relocationが可能です。

次のコマンドで元のコンテナレジストリ(ここではDockerHubとGoogle Container Registry)からHarborへrelocationできます。移行先のレジストリが自己署名証明書を使っている場合は --registry-ca-cert-path を指定してください。

kbld relocate -f images.lock --repository $HARBOR_HOST/library/guestbook --lock-output relocated.lock --registry-ca-cert-path $HOME/.config/tanzu/tkg/providers/ytt/03_customizations/harbor-ca.pem

次のようなログが出力されます。

Warning: Command "relocate" is deprecated, please use 'imgpkg copy', learn more in https://carvel.dev/imgpkg/docs/latest/commands/#copy
relocate | exporting 3 images...
relocate | will export gcr.io/google_samples/gb-frontend@sha256:dc8de8e0d569d2f828b187528c9317bd6b605c273ac5a282aebe471f630420fc
relocate | will export gcr.io/google_samples/gb-redis-follower@sha256:42707dbdccb4c8177523e2687c7b3cdb3d13473b0df1d3ef2c558fda09772c6f
relocate | will export index.docker.io/library/redis@sha256:800f2587bf3376cb01e6307afe599ddce9439deafbd4fb8562829da96085c9c5
relocate | exported 3 images
relocate | importing 3 images...
relocate | importing index.docker.io/library/redis@sha256:800f2587bf3376cb01e6307afe599ddce9439deafbd4fb8562829da96085c9c5 -> harbor-10-213-232-22.sslip.io/library/guestbook@sha256:800f2587bf3376cb01e6307afe599ddce9439deafbd4fb8562829da96085c9c5...
relocate | importing gcr.io/google_samples/gb-frontend@sha256:dc8de8e0d569d2f828b187528c9317bd6b605c273ac5a282aebe471f630420fc -> harbor-10-213-232-22.sslip.io/library/guestbook@sha256:dc8de8e0d569d2f828b187528c9317bd6b605c273ac5a282aebe471f630420fc...
relocate | importing gcr.io/google_samples/gb-redis-follower@sha256:42707dbdccb4c8177523e2687c7b3cdb3d13473b0df1d3ef2c558fda09772c6f -> harbor-10-213-232-22.sslip.io/library/guestbook@sha256:42707dbdccb4c8177523e2687c7b3cdb3d13473b0df1d3ef2c558fda09772c6f...
relocate | imported 3 images
Succeeded

Harborでlibrary/guestbookを確認すると、次の図のように3つのイメージが登録されています。移行先のイメージ名は同一($HARBOR_HOST/library/guestbook)で、異なるtagで分かれています。

image

変換先のイメージ名へのマッピングは、生成されたrelocated.lockに次のように出力されています。

apiVersion: kbld.k14s.io/v1alpha1
kind: Config
minimumRequiredVersion: 0.31.0
overrides:
- image: docker.io/redis:6.0.5
  newImage: harbor-10-213-232-22.sslip.io/library/guestbook@sha256:800f2587bf3376cb01e6307afe599ddce9439deafbd4fb8562829da96085c9c5
  preresolved: true
- image: gcr.io/google_samples/gb-frontend:v5
  newImage: harbor-10-213-232-22.sslip.io/library/guestbook@sha256:dc8de8e0d569d2f828b187528c9317bd6b605c273ac5a282aebe471f630420fc
  preresolved: true
- image: gcr.io/google_samples/gb-redis-follower:v2
  newImage: harbor-10-213-232-22.sslip.io/library/guestbook@sha256:42707dbdccb4c8177523e2687c7b3cdb3d13473b0df1d3ef2c558fda09772c6f
  preresolved: true
- image: gcr.io/google_samples/gb-frontend@sha256:dc8de8e0d569d2f828b187528c9317bd6b605c273ac5a282aebe471f630420fc
  newImage: harbor-10-213-232-22.sslip.io/library/guestbook@sha256:dc8de8e0d569d2f828b187528c9317bd6b605c273ac5a282aebe471f630420fc
  preresolved: true
- image: gcr.io/google_samples/gb-redis-follower@sha256:42707dbdccb4c8177523e2687c7b3cdb3d13473b0df1d3ef2c558fda09772c6f
  newImage: harbor-10-213-232-22.sslip.io/library/guestbook@sha256:42707dbdccb4c8177523e2687c7b3cdb3d13473b0df1d3ef2c558fda09772c6f
  preresolved: true
- image: index.docker.io/library/redis@sha256:800f2587bf3376cb01e6307afe599ddce9439deafbd4fb8562829da96085c9c5
  newImage: harbor-10-213-232-22.sslip.io/library/guestbook@sha256:800f2587bf3376cb01e6307afe599ddce9439deafbd4fb8562829da96085c9c5
  preresolved: true

このrelocate済みのlockファイルを使用して、次のコマンドを実行することで、relocateされたmanifestを生成することができます。

kbld -f config -f relocated.lock

出力は次の通りです。imageが全てHarborに置き換わっていることを確認してください。

---
apiVersion: apps/v1
kind: Deployment
metadata:
  annotations:
    kbld.k14s.io/images: |
      - origins:
        - preresolved:
            url: harbor-10-213-232-22.sslip.io/library/guestbook@sha256:dc8de8e0d569d2f828b187528c9317bd6b605c273ac5a282aebe471f630420fc
        url: harbor-10-213-232-22.sslip.io/library/guestbook@sha256:dc8de8e0d569d2f828b187528c9317bd6b605c273ac5a282aebe471f630420fc
  name: frontend
spec:
  replicas: 3
  selector:
    matchLabels:
      app: guestbook
      tier: frontend
  template:
    metadata:
      labels:
        app: guestbook
        tier: frontend
    spec:
      containers:
      - env:
        - name: GET_HOSTS_FROM
          value: dns
        image: harbor-10-213-232-22.sslip.io/library/guestbook@sha256:dc8de8e0d569d2f828b187528c9317bd6b605c273ac5a282aebe471f630420fc
        name: php-redis
        ports:
        - containerPort: 80
        resources:
          requests:
            cpu: 100m
            memory: 100Mi
---
apiVersion: v1
kind: Service
metadata:
  labels:
    app: guestbook
    tier: frontend
  name: frontend
spec:
  ports:
  - port: 80
  selector:
    app: guestbook
    tier: frontend
---
apiVersion: apps/v1
kind: Deployment
metadata:
  annotations:
    kbld.k14s.io/images: |
      - origins:
        - preresolved:
            url: harbor-10-213-232-22.sslip.io/library/guestbook@sha256:42707dbdccb4c8177523e2687c7b3cdb3d13473b0df1d3ef2c558fda09772c6f
        url: harbor-10-213-232-22.sslip.io/library/guestbook@sha256:42707dbdccb4c8177523e2687c7b3cdb3d13473b0df1d3ef2c558fda09772c6f
  labels:
    app: redis
    role: follower
    tier: backend
  name: redis-follower
spec:
  replicas: 2
  selector:
    matchLabels:
      app: redis
  template:
    metadata:
      labels:
        app: redis
        role: follower
        tier: backend
    spec:
      containers:
      - image: harbor-10-213-232-22.sslip.io/library/guestbook@sha256:42707dbdccb4c8177523e2687c7b3cdb3d13473b0df1d3ef2c558fda09772c6f
        name: follower
        ports:
        - containerPort: 6379
        resources:
          requests:
            cpu: 100m
            memory: 100Mi
---
apiVersion: v1
kind: Service
metadata:
  labels:
    app: redis
    role: follower
    tier: backend
  name: redis-follower
spec:
  ports:
  - port: 6379
  selector:
    app: redis
    role: follower
    tier: backend
---
apiVersion: apps/v1
kind: Deployment
metadata:
  annotations:
    kbld.k14s.io/images: |
      - origins:
        - preresolved:
            url: harbor-10-213-232-22.sslip.io/library/guestbook@sha256:800f2587bf3376cb01e6307afe599ddce9439deafbd4fb8562829da96085c9c5
        url: harbor-10-213-232-22.sslip.io/library/guestbook@sha256:800f2587bf3376cb01e6307afe599ddce9439deafbd4fb8562829da96085c9c5
  labels:
    app: redis
    role: leader
    tier: backend
  name: redis-leader
spec:
  replicas: 1
  selector:
    matchLabels:
      app: redis
  template:
    metadata:
      labels:
        app: redis
        role: leader
        tier: backend
    spec:
      containers:
      - image: harbor-10-213-232-22.sslip.io/library/guestbook@sha256:800f2587bf3376cb01e6307afe599ddce9439deafbd4fb8562829da96085c9c5
        name: leader
        ports:
        - containerPort: 6379
        resources:
          requests:
            cpu: 100m
            memory: 100Mi
---
apiVersion: v1
kind: Service
metadata:
  labels:
    app: redis
    role: leader
    tier: backend
  name: redis-leader
spec:
  ports:
  - port: 6379
    targetPort: 6379
  selector:
    app: redis
    role: leader
    tier: backend

このmanifestをkubectl applyで適用すればair-gappedな環境にguestbookをインストールすることができます。

tarファイルを経由して移行元のコンテナレジストリから移行先のコンテナレジストリへrelocation

完全にインターネットアクセスが遮断されている環境の場合、上記の方法が利用できません。 その場合は、一時的にtarファイルを経由することでrelocationできます。

次のコマンドを実行することでlockファイルに書かれた全てのイメージをダウンロードし、tarファイルにまとめることができます。

kbld package -f images.lock --output guestbook.tar

次のようなログが出力されます。各Dockerイメージの全てのlayerをダウンロードしていることがわかります。

Warning: Command "package" is deprecated, please use 'imgpkg push', learn more in https://carvel.dev/imgpkg/docs/latest/commands/#push
package | exporting 3 images...
package | will export gcr.io/google_samples/gb-frontend@sha256:dc8de8e0d569d2f828b187528c9317bd6b605c273ac5a282aebe471f630420fc
package | will export gcr.io/google_samples/gb-redis-follower@sha256:42707dbdccb4c8177523e2687c7b3cdb3d13473b0df1d3ef2c558fda09772c6f
package | will export index.docker.io/library/redis@sha256:800f2587bf3376cb01e6307afe599ddce9439deafbd4fb8562829da96085c9c5
package | exported 3 images
package | writing layers...
package | done: file 'manifest.json' (60.341µs)
package | done: file 'sha256-18fcacdee8c50bfd26be61e6f1a4f8ec366be232029a81392b070175eb8086b0.tar.gz' (86.049µs)
package | done: file 'sha256-a41be782ae7e5ade04fdcb9a1b7e47dfc657577d52ca2c56e69bc15d6ff0d9ab.tar.gz' (303.106µs)
package | done: file 'sha256-1e491fca5994eec2c4eea799393cb2261fd53972e306192495fd33ec10789c7d.tar.gz' (328.372614ms)
package | done: file 'sha256-cad41b2f70e519a55e1792d31026fd65c8c42f76e38944a584ff2719ab46327c.tar.gz' (29.941µs)
package | done: file 'sha256-79e2bb3c8c7d7e6f4700b36afc4bafefa4eae8b8d235c54961f8462d346429af.tar.gz' (279.894µs)
package | done: file 'sha256-d003069fe633e007e207bfc0b2084e0d3b19cabd7d7a308367946cd858fabcc6.tar.gz' (45.069µs)
package | done: file 'sha256-8949ef43a825d8300849dd9cb479ee0e797bbba65454cb45514f777790f7716d.tar.gz' (44.854µs)
package | done: file 'sha256-3347b8f8a6bb3d71e9dcd56712406b0cc244cb8d3f6d6f29b2d057cb12e16071.tar.gz' (38.106µs)
package | done: file 'sha256-229000940745435809100da0b14f1673c6b4d553050c3adf492a915fd9932527.tar.gz' (74.674µs)
package | done: file 'sha256-6831bc8b21065044f27b834e6959951a56e7be04b70b1c3ff4935f4f082911ae.tar.gz' (44.583µs)
package | done: file 'sha256-d13522578ad9c68f9a771d9dfc2a14315b97c7ee6690853b02cd9c261046d8b7.tar.gz' (71.002µs)
package | done: file 'sha256-8df5dd91de8744e600658d9bc0fe8762472a743f7bc9ddc11290c62e99ef33c5.tar.gz' (52.318µs)
package | done: file 'sha256-40087910590b3b16fd4006b5b33c8dcc8e8f7a90e6f5353d31125482e599fa9f.tar.gz' (97.159µs)
package | done: file 'sha256-f0f26ca0b5c28d69822884ac52a5c11834a3b4814107ea0b9062b995b53450e8.tar.gz' (43.77µs)
package | done: file 'sha256-5ce7b314b19cb499ab621f796ded0d51f065120efadc4db046fca0e209a4604d.tar.gz' (49.961µs)
package | done: file 'sha256-2e8f81c7b07f28d78092ab450f032cb5f0db66cb2c87696bca00a1548af00c15.tar.gz' (51.971µs)
package | done: file 'sha256-405e75bf6bb0104d67fcebf58e07cd21bf344589df9c1a41c00354a60ea3a604.tar.gz' (1.299420937s)
package | done: file 'sha256-5b11fc09c1a26b11a7df7d593adf43baff53c5cdba71cf8a87ae4a6dd17eb52c.tar.gz' (1.44004035s)
package | done: file 'sha256-33cc09c9b190539635d7c971301f623d94fda5b4b5647966c6c240902119009f.tar.gz' (872.424718ms)
package | done: file 'sha256-91875635f69d9961c1b3203c1ca80ec03b0ccab3a7bbe16e763a0636ea3cc45c.tar.gz' (2.97623912s)
package | done: file 'sha256-0bc5fc03390faf708237384e2d2bebf6d15fcb2ee6fd29590cc82b6a99a487d3.tar.gz' (31.961µs)
package | done: file 'sha256-6740c67243e3995aa86510395d873ad2d4b362cd64c881a32dba20d965a88b98.tar.gz' (28.423µs)
package | done: file 'sha256-04c4bfb0b023392acc73045aece284a6d14adfcb2cc74bce1e46bed266b8626a.tar.gz' (35.362µs)
package | done: file 'sha256-860f8957d8be856e2235a28e49fc4dca17254951e0eb67d760769755656f5cad.tar.gz' (3.015314259s)
package | done: file 'sha256-63dbb66c5119bb5086d9e6fb6b154211afc20b44ed136ab7df808f6044cfc6f1.tar.gz' (4.23970452s)
package | done: file 'sha256-5f87ad8ff31c56b999b8c50976cb4d780d3a65c4ac49929af53718877a53ac6b.tar.gz' (28.378µs)
package | done: file 'sha256-44264eaa8a750fb07340a6ab1cfb185534e02f60a775a803cd176b369de56f72.tar.gz' (810.135903ms)
package | done: file 'sha256-b69876b7abed8f17b52974bf0be00fcaf4d2d3d622bd2349c8e16407331e8b88.tar.gz' (99.872334ms)
package | done: file 'sha256-cda0ea55460bc42da178ec0cbd19648bfbcb6afefa33e274869edb8ab135f43e.tar.gz' (31.841µs)
package | done: file 'sha256-4878e74c8c6b5ff2fd3739f532749ac8b45aa996736e2a2f27dcc66594406245.tar.gz' (27.147µs)
package | done: file 'sha256-c4e50f4448ab04efcb3246f3bb1a7851c14230b4a19511065cb0d36dc3843166.tar.gz' (320.789073ms)
package | done: file 'sha256-35ea1373cc96d130eeb2b3d16463ca4112d4bd70253d826f4cc744154e4ab41d.tar.gz' (805.043788ms)
package | done: file 'sha256-02bd07740270c2e091dd2d53ff514e569ab6317f8e13127325c02b8f373799e7.tar.gz' (34.131µs)
package | done: file 'sha256-50e0f355ff269fbd8a5e68547368f185309f10ad76ff5843b48089b90f8e9efe.tar.gz' (44.002µs)
package | done: file 'sha256-03733ea6a63584425902e780cf1a3270cc136085ca96c08c11f1c3723424865e.tar.gz' (25.608µs)
package | done: file 'sha256-bd04f262ac91b3a38b06b8004da69851b15ca4cbc3a792e3764de72996c53372.tar.gz' (503.764345ms)
package | done: file 'sha256-ae79957c435c134f7eac689451a33d4d4a6561e9a1156f63f865dde409d3c341.tar.gz' (419.383099ms)
package | done: file 'sha256-1bacb18640994730a015fc7704e0cef48a50c2a829dc127acff37988f85a58cc.tar.gz' (53.103µs)
package | done: file 'sha256-04fe4ce897d62a8f1adc5d381f61c4a6ce437a73cfdf7775f5fc96ebde1fc7c7.tar.gz' (94.702798ms)
package | done: file 'sha256-a72d84b9df6aa0cd3bdee9e9ce6151139ef2f93fae7bd1726036a667b54f4798.tar.gz' (905.585836ms)
package | done: file 'sha256-d5ff438dbf35424bce6e08e9033a2e064d553c50b0c061a598565a0434420f24.tar.gz' (10.983677ms)
package | done: file 'sha256-df294a3127fb3f435b8573ed3749eea2c8ba0f500b0dfc3e72449e21b8dd8b4d.tar.gz' (1.583688834s)
package | done: file 'sha256-03a4abad74f97d7acb3497f868e3eaff523184606b54ecdbf176bfe85a10e796.tar.gz' (712.11204ms)
package | done: file 'sha256-862b2b6c212df122d0cc5b0bc23864c5874de338f17b0dfa7da836aeca0b9f98.tar.gz' (142.748755ms)
package | done: file 'sha256-059f03d738ad08278e0a4c25ca340c43ee5ac09fd89ec4958a1577f24c61c495.tar.gz' (60.169µs)
package | done: file 'sha256-6a864f6e4c8d1d717410a06ce2df7968ce243151f41c31b276de9c37b9c903a0.tar.gz' (57.177µs)
package | done: file 'sha256-3c641f1df61fc7d52d72d38d2f33f5eda5d07c734b49cb8a6c27ab19dd4a82b6.tar.gz' (134.01592ms)
package | done: file 'sha256-f08f0aaf2b28c6273ae9d36fd5290631b23d20bd95ed8b199b0112100f1df940.tar.gz' (14.459159778s)
package | done: file 'sha256-95aa1587cc1d863f1578c056d9349b284081c1747f95afc930dff5d76257b343.tar.gz' (29.087µs)
package | done: file 'sha256-8559a31e96f442f2c7b6da49d6c84705f98a39d8be10b3f5f14821d0ee8417df.tar.gz' (873.402364ms)
package | done: file 'sha256-8ca7577888307f392a71a9e051a2635001440b124e3b3ae5cb3e10e8dca0906a.tar.gz' (94.441462ms)
package | done: file 'sha256-2dd003996c9ab82cac8112be0a4c04068e666e7a5d0cce3c65fb8f064de284e7.tar.gz' (1.261087934s)
package | done: file 'sha256-25d34e6a8c07fe57114baaa650962827351af5046989cc2361d695a748ecac04.tar.gz' (37.005685ms)
package | done: file 'sha256-3327f7a496f3f9a645339962c5ff7707e5d3d8527605c0b61e2437df8d05d57e.tar.gz' (40.329µs)
package | done: file 'sha256-904a0292174da3a627c8e999351f8879c6bfabde14163b2ae51607d0c1120cf4.tar.gz' (36.101µs)
package | done: file 'sha256-0027e794f2380b6fb5275c0b6c78e9cbcc29821b043c51ad81ca54eb46a801a7.tar.gz' (13.058894778s)
package | done: file 'sha256-98037b32ce5f6bbc4cdfb87147f17d72d114cc4631d91a4f55385aa5abc97efa.tar.gz' (39.368µs)
package | done: file 'sha256-38cf5d0545e9b0b3b3996fcd484cb25823b9bb2163b3675d809479a093a319bc.tar.gz' (30.64µs)
package | done: file 'sha256-0afca0c798a59b50622df9aaad0dd407f7c7b9f77999cab832f70bffd3c8c63f.tar.gz' (1.535029706s)
package | done: file 'sha256-85a6a5c53ff0d7433fa114f3d8b94992deda869addc164bd15ce40e2f72f0fd6.tar.gz' (42.122µs)
package | done: file 'sha256-6482c539a928e9561b259316816a6933b2cd8ddd0d703ebc73aa310db2c8c7cd.tar.gz' (86.760861ms)
package | done: file 'sha256-76f2a0c8ea98ebd699a77ced9c677e97cd54b038a8c5e89670af78f38b047b33.tar.gz' (1.41301884s)
package | done: file 'sha256-b1ad81e0d5836d20a5deab240146c524b20f1c4eb3fcdab4fd05f9e7567e9a1e.tar.gz' (68.776015ms)
package | done: file 'sha256-8cd20313beb311f9333c1f47bbe7694bb922e79f5403daa59e5e16ff79e9db43.tar.gz' (53.043µs)
package | done: file 'sha256-80cabc759585527d8170ded333679a336272d34fe3d3639eb81fcd4afd554b4b.tar.gz' (722.85573ms)
package | done: file 'sha256-ffbb094f4f9e7c61d97c2b409f3e8154e2621a5074a0087d35f1849e665d0d34.tar.gz' (3.441899792s)
Succeeded

出来上がったtarファイルは全イメージを含むのでサイズが大きいです。

$ ls -lh guestbook.tar 
-rw-r--r--  1 toshiaki  wheel   611M Dec 12 13:59 guestbook.tar

このtarファイルをUSBメモリなどを使用して、air-gapped環境に持ち込みます。

air-gapped環境で、次のコマンドを実行しHarborにrelocateします。

kbld unpackage -i guestbook.tar -f images.lock --repository $HARBOR_HOST/library/guestbook --lock-output relocated.lock --registry-ca-cert-path $HOME/.config/tanzu/tkg/providers/ytt/03_customizations/harbor-ca.pem

次のようなログが出力されます。

Warning: Command "unpackage" is deprecated, please use 'imgpkg pull', learn more in https://carvel.dev/imgpkg/docs/latest/commands/#pull
unpackage | importing 3 images...
unpackage | importing gcr.io/google_samples/gb-frontend@sha256:dc8de8e0d569d2f828b187528c9317bd6b605c273ac5a282aebe471f630420fc -> harbor-10-213-232-22.sslip.io/library/guestbook@sha256:dc8de8e0d569d2f828b187528c9317bd6b605c273ac5a282aebe471f630420fc...
unpackage | importing index.docker.io/library/redis@sha256:800f2587bf3376cb01e6307afe599ddce9439deafbd4fb8562829da96085c9c5 -> harbor-10-213-232-22.sslip.io/library/guestbook@sha256:800f2587bf3376cb01e6307afe599ddce9439deafbd4fb8562829da96085c9c5...
unpackage | importing gcr.io/google_samples/gb-redis-follower@sha256:42707dbdccb4c8177523e2687c7b3cdb3d13473b0df1d3ef2c558fda09772c6f -> harbor-10-213-232-22.sslip.io/library/guestbook@sha256:42707dbdccb4c8177523e2687c7b3cdb3d13473b0df1d3ef2c558fda09772c6f...
unpackage | imported 3 images
Succeeded

前と同じく、次の図のようにHarborには同一のイメージ名($HARBOR_HOST/library/guestbook)でtagが異なる3つのイメージが登録されています。

image

前と同じく、次のコマンドでrelocateされたHarbor上のイメージを使ってguestbookをインストールするためのmanifestが生成されます。

kbld -f config -f relocated.lock

kbldを使うことで簡単にイメージのrelocationを行えることを確認しました。

ところで、ログに次のようなメッセージが出ていることに気づいたかもしれません。

Warning: Command "package" is deprecated, please use 'imgpkg push', learn more in https://carvel.dev/imgpkg/docs/latest/commands/#push

本記事で紹介したkbld package / kbld unpackageは実はdeprecatedであり、 今後は代わりに imgpkg を使用することを促されています。

kbld packageとimgpkg pushは全く同じ機能というわけではありません。 imgpkgはマニフェストをimgpkg bundleというフォーマットでOCIイメージにパッケージングし、コンテナレジストリで配布可能にします。 このimgpkg bundleはmanifest + imageのtarファイルにexportすることができます。すなわちkbldより内容が多いtarファイルが生成されます。

次の記事ではimgpkgを使ってイメージをrelocateする方法を紹介します。

✒️️ Edit  ⏰ History  🗑 Delete