Harbor インスタンスは、組織の信頼できるルート認証局(CA)によって発行された Transport Layer Security(TLS)証明書を使用します。これにより、Docker クライアントと Harbor レジストリ間の接続が暗号化され、不正アクセスからイメージが保護されます。
このページでは、Harbor ルート CA を信頼するようにワークステーションで Docker クライアントを構成する方法について説明します。GDC は、Harbor レジストリ インスタンスを自動的に信頼するようにクラスタノードを構成するため、Kubernetes クラスタのノードで信頼を構成する必要はありません。詳細については、Harbor レジストリ インスタンスのクラスタノードの信頼をご覧ください。
始める前に
コンテナ イメージを管理する前に、次の手順を行う必要があります。
- Docker をまだインストールしていない場合は、https://docs.docker.com/engine/install/ubuntu/ の手順に沿ってインストールします。Docker は Cloud Shell に含まれています。
Docker がレジストリを操作するには特権アクセスが必要です。Linux や Windows では、Docker コマンドを実行するユーザーを Docker セキュリティ グループに追加します。Docker Desktop は、root ユーザーとして仮想マシンで実行されるため、この手順は MacOS では不要です。
Linux の場合は、ユーザーを追加します。
sudo usermod -a -G docker USERWindows の場合:
net localgroup docker-users DOMAIN\Upan>SER /addUSERは、追加するユーザー名に置き換えます。
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 クライアントを構成したら、接続設定を完了してレジストリの使用を開始します。