5.16. マルチプラットフォームをサポートするための Operator プロジェクトの設定

手順

1. Operator とオペランドのイメージマニフェストを調べて、Operator プロジェクトがサポートできるプラットフォームを見つけます。次のコマンドを実行して、イメージマニフェストを検査します。

   $ docker manifest inspect <image_manifest> 

   1

   1

   redhat/ubi9:latest などのイメージマニフェストを指定します。

   Operator とオペランドが相互にサポートするプラットフォームによって、Operator プロジェクトのプラットフォーム互換性が決まります。

   出力例

   {
       "manifests": [
           {
               "digest": "sha256:c0669ef34cdc14332c0f1ab0c2c01acb91d96014b172f1a76f3a39e63d1f0bda",
               "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
               "platform": {
                   "architecture": "amd64",
                   "os": "linux"
               },
               "size": 528
           },
   ...
           {
               "digest": "sha256:30e6d35703c578ee703230b9dc87ada2ba958c1928615ac8a674fcbbcbb0f281",
               "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
               "platform": {
                   "architecture": "arm64",
                   "os": "linux",
                   "variant": "v8"
               },
               "size": 528
           },
   ...
       ]
   }

2. 前のコマンドでプラットフォーム情報が出力されない場合、指定されたベースイメージはイメージマニフェストではなく単一イメージである可能性があります。次のコマンドを実行すると、イメージがサポートするアーキテクチャーを確認できます。

   $ docker inspect <image>

3. Go ベースの Operator プロジェクトの場合、Operator SDK はプロジェクトの Dockerfile で amd64 アーキテクチャーを明示的に参照します。Dockerfile に次の変更を加えて、環境変数をプラットフォームフラグで指定された値に設定します。

   Dockerfile の例

   FROM golang:1.19 as builder
   ARG TARGETOS
   ARG TARGETARCH
   ...
   RUN CGO_ENABLED=0 GOOS=${TARGETOS:-linux} GOARCH=${TARGETARCH} go build -a -o manager main.go 

   1

   1

   GOARCH フィールドを amd64 から $TARGETARCH に変更します。

4. Operator プロジェクトの makefile は、PLATFORMS 環境変数を定義します。Operator のイメージがデフォルトで設定されているプラットフォームの一部をサポートしていない場合は、変数を編集してサポートされているプラットフォームを指定します。次の例では、サポートされるプラットフォームを linux/arm64 および linux/amd64 として定義します。

   例 makefile

   # ...
   PLATFORMS ?= linux/arm64,linux/amd64 

   1

   
   .PHONY: docker-buildx
   # ...

   1

   デフォルトでは、次の PLATFORMS 値が設定されています (linux/arm64、linux/amd64、linux/s390x、および linux/ppc64le)。

   make docker buildx コマンドを実行してマニフェストリストを生成すると、Operator SDK は PLATFORMS 変数で指定されたプラットフォームごとにイメージマニフェストを作成します。

5. Operator プロジェクトディレクトリーから次のコマンドを実行して、マネージャーイメージを構築します。コマンドを実行すると、マルチプラットフォームをサポートするマネージャーイメージが構築され、マニフェストリストがレジストリーにプッシュされます。

   $ make docker-buildx \
     IMG=<image_registry>/<organization_name>/<repository_name>:<version_or_sha>