Harbor ルート CA を信頼するように Docker を構成する

Harbor インスタンスは、組織の信頼できるルート認証局(CA)によって発行された Transport Layer Security(TLS)証明書を使用します。これにより、Docker クライアントと Harbor レジストリ間の接続が暗号化され、不正アクセスからイメージが保護されます。

このページでは、Harbor ルート CA を信頼するようにワークステーションで Docker クライアントを構成する方法について説明します。GDC は、Harbor レジストリ インスタンスを自動的に信頼するようにクラスタノードを構成するため、Kubernetes クラスタのノードで信頼を構成する必要はありません。詳細については、Harbor レジストリ インスタンスのクラスタノードの信頼をご覧ください。

始める前に

コンテナ イメージを管理する前に、次の手順を行う必要があります。

  1. Docker をまだインストールしていない場合は、https://docs.docker.com/engine/install/ubuntu/ の手順に沿ってインストールします。Docker は Cloud Shell に含まれています。
  2. Docker がレジストリを操作するには特権アクセスが必要です。Linux や Windows では、Docker コマンドを実行するユーザーを Docker セキュリティ グループに追加します。Docker Desktop は、root ユーザーとして仮想マシンで実行されるため、この手順は MacOS では不要です。

    1. Linux の場合は、ユーザーを追加します。

        sudo usermod -a -G docker USER
      
    2. Windows の場合:

        net localgroup docker-users DOMAIN\Upan>SER /add
      

      USER は、追加するユーザー名に置き換えます。

Harbor ルート CA を信頼するように Docker を構成する

Docker クライアントを使用して Harbor インスタンスと通信する場合は、組織のルート CA を信頼するようにローカル Docker クライアントを構成する必要があります。

ルート CA を信頼するように Docker クライアントを構成するには、組織管理者からルート CA の .crt ファイルをリクエストし、組織のルート CA を次の場所にコピーします。

/etc/docker/certs.d/HARBOR_INSTANCE_URL/ca.crt

HARBOR_INSTANCE_URL は、Harbor インスタンスの URL に置き換えます。例: harbor-1.org-1.zone1.google.gdc.test

このコマンドにより、Docker クライアントは Harbor インスタンスとの HTTPS 接続を確立できます。

または、gdcloud CLI を使用して組織にログインし、Management API サーバーの kubeconfig ファイルを生成して使用し、クラスタ内の信頼バンドルをコピーします。詳細については、GDC 信頼バンドルを取得するをご覧ください。

  export REGISTRY=HARBOR_INSTANCE_URL
  mkdir -p /etc/docker/certs.d/${REGISTRY} && echo $(kubectl get secret trust-store-global-root-ext -n platform -o \
  jsonpath='{.data.ca\.crt}') | openssl base64 -A -d > \
  /etc/docker/certs.d/${REGISTRY}/ca.crt

HARBOR_INSTANCE_URL は、Harbor インスタンスの URL に置き換えます。例: harbor-1.org-1.zone1.google.gdc.test

構成が失敗すると、次のエラー メッセージが表示されます。

Error response from daemon: Get "https://<HARBOR_INSTANCE_URL>": x509: certificate signed by unknown authority

手順を繰り返してこの問題を解決し、必要に応じて GDC エンジニアリングにエスカレーションします。

Kubernetes クラスタ上の Pod が Harbor レジストリ インスタンスからイメージを pull するときに x509: certificate signed by unknown authority エラーが表示される場合は、イメージの pull 時の証明書エラーのトラブルシューティングをご覧ください。

次のステップ

Harbor ルート CA を信頼するように Docker クライアントを構成したら、接続設定を完了してレジストリの使用を開始します。