第21章 Azure の設定

手順

1. Azure CLI を使用して、アカウントのサブスクリプション ID を取得します。

   # az account list
   [
   {
     "cloudName": "AzureCloud",
     "id": "<subscription>", 1
     "isDefault": false,
     "name": "Pay-As-You-Go",
     "state": "Enabled",
     "tenantId": "<tenant-id>",
     "user": {
       "name": "admin@example.com",
       "type": "user"
     }
   ]

   1

   新規パーミッションを作成するために使用するサブスクリプション ID。

2. コントリビューターの Microsoft Azure ロールおよび Microsoft Azure サブスクリプションおよびリソースグループのスコープでサービスプリンシパルを作成します。インベントリーを定義する際に使用されるこれらの値の出力を記録します。以下の値の代わりに、直前の手順の <subscription> 値を使用します。

   # az ad sp create-for-rbac --name openshiftcloudprovider \
        --password <secret> --role contributor \
        --scopes /subscriptions/<subscription>/resourceGroups/<resource-group>
   
   Retrying role assignment creation: 1/36
   Retrying role assignment creation: 2/36
   {
     "appId": "<app-id>",
     "displayName": "ocpcloudprovider",
     "name": "http://ocpcloudprovider",
     "password": "<secret>",
     "tenant": "<tenant-id>"
   }

1. Azure ストレージアカウントを作成します。

   az storage account create
   --name <account_name> \
   --resource-group <resource_group> \
   --location <location> \
   --sku Standard_LRS

   これによってアカウントキーが作成されます。アカウントキーを表示するには、以下を実行します。

   az storage account keys list \
       --account-name <account-name> \
       --resource-group <resource-group> \
       --output table
   
   KeyName    Permissions    Value
   key1       Full           <account-key>
   key2       Full           <extra-account-key>

手順

1. レジストリーでストレージアカウントを使用できるように Ansible インベントリーを設定します。

   [OSEv3:vars]
   # Azure Registry Configuration
   openshift_hosted_registry_replicas=1 1
   openshift_hosted_registry_storage_kind=object
   openshift_hosted_registry_storage_azure_blob_accountkey=<account_key> 2
   openshift_hosted_registry_storage_provider=azure_blob
   openshift_hosted_registry_storage_azure_blob_accountname=<account_name> 3
   openshift_hosted_registry_storage_azure_blob_container=<registry> 4
   openshift_hosted_registry_storage_azure_blob_realm=core.windows.net

   1

   設定するレプリカ数

   2

   <account-name> に関連付けられたアカウントキー。

   3

   ストレージアカウント名。

   4

   データの保存に使用するディレクトリー。デフォルトは registry

手順

1. 現在の config.yml をエクスポートします。

   $ oc get secret registry-config \
       -o jsonpath='{.data.config\.yml}' -n default | base64 -d \
     >> config.yml.old

2. 古い config.yml から新規の設定ファイルを作成します。

   $ cp config.yml.old config.yml

3. ファイルを編集して Azure パラメーターを含めます。

   storage:
     delete:
       enabled: true
     cache:
       blobdescriptor: inmemory
     azure:
       accountname: <account-name> 1
       accountkey: <account-key> 2
       container: registry 3
       realm: core.windows.net 4

   1

   ストレージアカウント名に置き換えます。

   2

   <account-name> に関連付けられたアカウントキー。

   3

   データの保存に使用するディレクトリー。デフォルトは registry

   4

   デフォルトのストレージレルム core.windows.net

4. registry-config シークレットを削除します。

   $ oc delete secret registry-config -n default

5. シークレットを再作成して、更新された構成ファイルを参照します。

   $ oc create secret generic registry-config \
       --from-file=config.yml -n default

6. 更新された設定を読み取るためにレジストリーを再デプロイします。

   $ oc rollout latest docker-registry -n default

手順

1. レジストリーの正常なデプロイ後に、レジストリー deploymentconfig は常にレジストリーが Microsoft Azure Blob ストレージではなく emptydir を使用していることを示します。

   $ oc describe dc docker-registry -n default
   ...
   Mounts:
     ...
     /registry from registry-storage (rw)
   Volumes:
   registry-storage:
   Type:       EmptyDir 1
   ...

   1

   Pod の寿命を共有する一時ディレクトリー

2. /registry のマウントポイントが空かどうかを確認します。これは、Microsoft Azure ストレージが使用するボリュームです。

   $ oc exec \
       $(oc get pod -l deploymentconfig=docker-registry \
       -o=jsonpath='{.items[0].metadata.name}')  -i -t -- ls -l /registry
   total 0

3. 空の場合は、Microsoft Azure Blob 設定が registry-config シークレットで実行されていることを示します。

   $ oc describe secret registry-config
   Name:         registry-config
   Namespace:    default
   Labels:       <none>
   Annotations:  <none>
   
   Type:  Opaque
   
   Data
   ====
   config.yml:  398 bytes

4. インストーラーは、「インストールドキュメントのストレージ」セクションで記載されているように、拡張されたレジストリー機能を使用して、希望の設定で config.yml ファイルを作成します。以下のコマンドで、ストレージバケット設定が保存されている storage セクションを含めて設定ファイルを表示します。

   $ oc exec \
       $(oc get pod -l deploymentconfig=docker-registry \
         -o=jsonpath='{.items[0].metadata.name}') \
     cat /etc/registry/config.yml
   
     version: 0.1
     log:
       level: debug
     http:
       addr: :5000
     storage:
       delete:
         enabled: true
       cache:
         blobdescriptor: inmemory
       azure:
         accountname: registry
         accountkey: uZekVBJBa6xzwAqK8EDz15/hoHUoc8I6cPfP31ZS+QOSxLfo7WT7CLrVPKaqvtNTMgztxH7CGjYfpFRNUhvMiA==
         container: registry
         realm: core.windows.net
     auth:
       openshift:
         realm: openshift
     middleware:
       registry:
       - name: openshift
       repository:
       - name: openshift
         options:
           pullthrough: True
           acceptschema2: True
           enforcequota: False
       storage:
       - name: openshift

   または、以下でシークレットを表示できます。

   $ oc get secret registry-config -o jsonpath='{.data.config\.yml}' | base64 -d
   version: 0.1
   log:
     level: debug
   http:
     addr: :5000
   storage:
     delete:
       enabled: true
     cache:
       blobdescriptor: inmemory
     azure:
       accountname: registry
       accountkey: uZekVBJBa6xzwAqK8EDz15/hoHUoc8I6cPfP31ZS+QOSxLfo7WT7CLrVPKaqvtNTMgztxH7CGjYfpFRNUhvMiA==
       container: registry
       realm: core.windows.net
   auth:
     openshift:
       realm: openshift
   middleware:
     registry:
     - name: openshift
     repository:
     - name: openshift
       options:
         pullthrough: True
         acceptschema2: True
         enforcequota: False
     storage:
     - name: openshift

手順

1. 以下の storageclass は、インストール時に、Ansible インベントリーで openshift_cloudprovider_kind=azure および openshift_cloud_provider_azure 変数を使用して Azure クラウドプロバイダーを設定する場合に作成されます。

   $ oc get --export storageclass azure-standard -o yaml
   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     annotations:
       storageclass.kubernetes.io/is-default-class: "true"
     creationTimestamp: null
     name: azure-standard
   parameters:
     kind: Shared
     storageaccounttype: Standard_LRS
   provisioner: kubernetes.io/azure-disk
   reclaimPolicy: Delete
   volumeBindingMode: Immediate

   Ansible を使用して OpenShift Container Platform と Microsoft Azure の統合を有効にしていない場合には、storageclass を手動で作成できます。詳細は、「動的プロビジョニングとストレージクラスの作成」セクションを参照してください。

2. 現時点で、デフォルトの storageclass の種類は shared であり、これは Microsoft Azure インスタンスがアンマネージドディスクを使用する必要があることを意味しています。インストール時に Ansible インベントリーファイルに openshift_storageclass_parameters={'kind': 'Managed', 'storageaccounttype': 'Premium_LRS'} または openshift_storageclass_parameters={'kind': 'Managed', 'storageaccounttype': 'Standard_LRS'} 変数を指定し、インスタンスがマネージドディスクを使用できるようにすることで、この設定をオプションで変更することができます。

手順

1. 新規アプリケーションを作成します。

   $ oc new-app openshift/hello-openshift

2. ロードバランサーサービスを公開します。

   $ oc expose dc hello-openshift --name='hello-openshift-external' --type='LoadBalancer'

   これにより、以下と同様の Loadbalancer サービスが作成されます。

   apiVersion: v1
   kind: Service
   metadata:
     labels:
       app: hello-openshift
     name: hello-openshift-external
   spec:
     externalTrafficPolicy: Cluster
     ports:
     - name: port-1
       nodePort: 30714
       port: 8080
       protocol: TCP
       targetPort: 8080
     - name: port-2
       nodePort: 30122
       port: 8888
       protocol: TCP
       targetPort: 8888
     selector:
       app: hello-openshift
       deploymentconfig: hello-openshift
     sessionAffinity: None
     type: LoadBalancer

3. サービスが作成されたことを確認します。

   $ oc get svc
   NAME                       TYPE           CLUSTER-IP       EXTERNAL-IP     PORT(S)                         AGE
   hello-openshift            ClusterIP      172.30.223.255   <none>          8080/TCP,8888/TCP               1m
   hello-openshift-external   LoadBalancer   172.30.99.54     40.121.42.180   8080:30714/TCP,8888:30122/TCP   4m

   LoadBalancer タイプおよび External-IP フィールドは、サービスが Microsoft Azure ロードバランサーを使用してアプリケーションを公開することを示しています。