Image Registry サービスはオープンソースプロジェクトである Harbor を利用して提供されます。Docker Image 管理のためのストレージ機能とユーザー認証機能を提供します。 

複数のユーザー向けにサービスを提供するために、Public/Private プロジェクトを作成してイメージを管理できます。追加の詳細は、以下のガイドやオープンソースプロジェクトサイトの ユーザーガイド を参照してください。 

サービスを使用するには、ZCP Console のサイドメニューから Image Registry をクリックします。

アカウント登録

Harbor の左下にある Sign up for an account リンクをクリックしてアカウントを作成し、Harbor にログインします。

Image Registry プロジェクトの確認

プロジェクト一覧の確認

システムにログインした後、最初の画面の左側メニューの上部にある Projects メニューをクリックすると、プロジェクト一覧を確認できます。 

Image の確認

プロジェクト一覧画面で Project Name リンクをクリックします。 

すると、プロジェクトに含まれている Image の一覧が表示されます。 

プロジェクトへの Image Push

Docker Client を使用...

Image Registry にログイン

Public プロジェクトに Image を Push したり、Private プロジェクトに Image を Pull または Push するためには、Image Registry にログインする必要があります。 

以下のコマンドを実行すると、すぐにログインできます。ログインするには、プロジェクトのメンバーとして登録されている必要があります。 

$ docker login [IMAGE_REGISTRY_URL]
Username:                           # Image Registry ユーザーアカウント
Password:                           # Image Registry ユーザーパスワード

Image Push

Docker コマンドを使用して Push する方法は、通常の Image Push の方法と同じです。Push の前に docker login を実行してください。 

# イメージの Tag を作成します。
$ docker tag SOURCE_IMAGE[:TAG] [IMAGE_REGISTRY_URL]/[プロジェクト名]/IMAGE[:TAG]

# イメージを Push します。
$ docker push [IMAGE_REGISTRY_URL]/[プロジェクト名]/IMAGE[:TAG]

Image Pull 

Docker コマンドを使用して Pull する方法は、アクセス可能な Image を指定するだけです。 

$ docker pull [IMAGE_REGISTRY_URL]/[プロジェクト名]/IMAGE[:TAG]

Docker コマンドを使用して Pull する方法は、アクセス可能な Image を入力するだけです。 

$ docker pull [IMAGE_REGISTRY_URL]/[プロジェクト名]/IMAGE[:TAG]

Kubernetes Podで...

ImagePullSecret の作成と登録

Kubernetes Podで Private Image Registry を使用する場合、Docker login のような認証処理が必要です。これを実現するために ImagePullSecret を使用します。

ネームスペースに作成された Secret を以下のコマンドで確認します。

$ kubectl get secret --namespace my-namespace
NAME                  TYPE                                  DATA      AGE
my-docker-secret      kubernetes.io/dockerconfigjson        1         1d
my-tls-secret         kubernetes.io/tls                     2         1d

Pod を作成する際に、以下のように imagePullSecrets に Secret 名を追加すると、Pod 作成時に該当の Image を使用できます。 

apiVersion: v1
kind: Pod
metadata:
  name: private-reg
spec:
  containers:
  - name: private-reg-container
    image: [IMAGE_REGISTRY_URL]/[プロジェクト名]/IMAGE[:TAG]
  imagePullSecrets:
  - name: my-docker-secret