ホーム
製品
OpenShift Container Platform
4.18
BuildConfig を使用してビルドする
3.8. プライベートレジストリーでの docker 認証情報の使用

3.8. プライベートレジストリーでの docker 認証情報の使用

プライベートコンテナーレジストリーの有効な認証情報を指定して、.docker/config.json ファイルで builds を提供できます。これにより、プライベートコンテナーイメージレジストリーにアウトプットイメージをプッシュしたり、認証を必要とするプライベートコンテナーイメージレジストリーからビルダーイメージをプルすることができます。

同じレジストリー内に、レジストリーパスに固有の認証情報を指定して、複数のリポジトリーに認証情報を指定できます。

注記

OpenShift Container Platform コンテナーイメージレジストリーでは、OpenShift Container Platform が自動的にシークレットを生成するので、この作業は必要ありません。

デフォルトでは、.docker/config.json ファイルはホームディレクトリーにあり、以下の形式となっています。

auths:
  index.docker.io/v1/: 
    auth: "YWRfbGzhcGU6R2labnRib21ifTE=" 
    email: "user@example.com" 
  docker.io/my-namespace/my-user/my-image: 
    auth: "GzhYWRGU6R2fbclabnRgbkSp=""
    email: "user@example.com"
  docker.io/my-namespace: 
    auth: "GzhYWRGU6R2deesfrRgbkSp=""
    email: "user@example.com"

auths:
  index.docker.io/v1/:


    auth: "YWRfbGzhcGU6R2labnRib21ifTE="


    email: "user@example.com"


  docker.io/my-namespace/my-user/my-image:


    auth: "GzhYWRGU6R2fbclabnRgbkSp=""
    email: "user@example.com"
  docker.io/my-namespace:


    auth: "GzhYWRGU6R2deesfrRgbkSp=""
    email: "user@example.com"

Copy to Clipboard

Toggle word wrap

1: レジストリーの URL
2: 暗号化されたパスワード
3: ログイン用のメールアドレス
4: namespace 内の特定イメージの URL および認証情報
5: レジストリー namespace の URL および認証情報

複数のコンテナーイメージレジストリーを定義するか、同じレジストリーに複数のリポジトリーを定義することができます。または docker login コマンドを実行して、このファイルに認証エントリーを追加することも可能です。ファイルが存在しない場合には作成されます。

Kubernetes では Secret オブジェクトが提供され、これを使用して設定とパスワードを保存することができます。

前提条件

.docker/config.json ファイルが必要です。

手順

次のコマンドを入力して、ローカルの .docker/config.json ファイルからシークレットを作成します。
```
oc create secret generic dockerhub \
    --from-file=.dockerconfigjson=<path/to/.docker/config.json> \
    --type=kubernetes.io/dockerconfigjson
```
```
$ oc create secret generic dockerhub \
    --from-file=.dockerconfigjson=<path/to/.docker/config.json> \
    --type=kubernetes.io/dockerconfigjson
```
Copy to Clipboard Toggle word wrap
これにより、dockerhub という名前のシークレットの JSON 仕様が生成され、オブジェクトが作成されます。
pushSecret フィールドを BuildConfig の output セクションに追加し、作成した secret の名前 (上記の例では、dockerhub) に設定します。
```
spec:
  output:
    to:
      kind: "DockerImage"
      name: "private.registry.com/org/private-image:latest"
    pushSecret:
      name: "dockerhub"
```
```
spec:
  output:
    to:
      kind: "DockerImage"
      name: "private.registry.com/org/private-image:latest"
    pushSecret:
      name: "dockerhub"
```
Copy to Clipboard Toggle word wrap
oc set build-secret コマンドを使用して、ビルド設定にプッシュするシークレットを設定します。
```
oc set build-secret --push bc/sample-build dockerhub
```
```
$ oc set build-secret --push bc/sample-build dockerhub
```
Copy to Clipboard Toggle word wrap
pushSecret フィールドを指定する代わりに、プッシュシークレットをビルドで使用されるサービスアカウントにリンクできます。デフォルトで、builds は builder サービスアカウントを使用します。シークレットにビルドのアウトプットイメージをホストするリポジトリーに一致する認証情報が含まれる場合、プッシュシークレットはビルドに自動的に追加されます。
```
oc secrets link builder dockerhub
```
```
$ oc secrets link builder dockerhub
```
Copy to Clipboard Toggle word wrap
ビルドストラテジー定義に含まれる pullSecret を指定して、プライベートコンテナーイメージレジストリーからビルダーコンテナーイメージをプルします。
```
strategy:
  sourceStrategy:
    from:
      kind: "DockerImage"
      name: "docker.io/user/private_repository"
    pullSecret:
      name: "dockerhub"
```
```
strategy:
  sourceStrategy:
    from:
      kind: "DockerImage"
      name: "docker.io/user/private_repository"
    pullSecret:
      name: "dockerhub"
```
Copy to Clipboard Toggle word wrap
oc set build-secret コマンドを使用して、ビルド設定でプルシークレットを設定します。
```
oc set build-secret --pull bc/sample-build dockerhub
```
```
$ oc set build-secret --pull bc/sample-build dockerhub
```
Copy to Clipboard Toggle word wrap
注記
以下の例では、ソールビルドに pullSecret を使用しますが、Docker とカスタム builds にも該当します。
pullSecret フィールドを指定する代わりに、プルシークレットをビルドで使用されるサービスアカウントにリンクできます。デフォルトで、builds は builder サービスアカウントを使用します。シークレットにビルドのインプットイメージをホストするリポジトリーに一致する認証情報が含まれる場合、プルシークレットはビルドに自動的に追加されます。pullSecret フィールドを指定する代わりに、ビルドで使用されるサービスアカウントにプルシークレットをリンクするには、次のコマンドを入力します。
```
oc secrets link builder dockerhub
```
```
$ oc secrets link builder dockerhub
```
Copy to Clipboard Toggle word wrap
注記
この機能を使用するには、from イメージを BuildConfig 仕様に指定する必要があります。oc new-build または oc new-app で生成される Docker ストラテジービルドは、場合によってこれを実行しない場合があります。

トップに戻る

3.8. プライベートレジストリーでの docker 認証情報の使用

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links