Azure Red Hat OpenShift 4 で Azure Files StorageClass を作成する

この記事では、Azure Files を使用して ReadWriteMany (RWX) ストレージを動的にプロビジョニングする Azure Red Hat OpenShift 4 用の StorageClass を作成します。 学習内容は次のとおりです。

CLI をローカルにインストールして使用する場合、このチュートリアルでは、Azure CLI バージョン 2.6.0 以降を実行している必要があります。 バージョンを確認するには、az --version を実行します。 インストールまたはアップグレードする必要がある場合は、Azure CLI のインストールに関するページを参照してください。

開始する前に

Azure Red Hat OpenShift 4 クラスターをお使いのサブスクリプションにデプロイします。「Azure Red Hat OpenShift 4 クラスターを作成する」を参照してください

Azure ストレージ アカウントを設定する

この手順では、Azure Red Hat OpenShift (ARO) クラスターのリソース グループ以外にリソース グループを作成します。 このリソース グループには、Azure Red Hat OpenShift の動的なプロビジョナーを作成した Azure Files 共有が含まれます。

AZURE_FILES_RESOURCE_GROUP=aro_azure_files
LOCATION=eastus

az group create -l $LOCATION -n $AZURE_FILES_RESOURCE_GROUP

AZURE_STORAGE_ACCOUNT_NAME=aroazurefilessa

az storage account create \
	--name $AZURE_STORAGE_ACCOUNT_NAME \
	--resource-group $AZURE_FILES_RESOURCE_GROUP \
	--kind StorageV2 \
	--sku Standard_LRS

アクセス許可を設定する

リソース グループのアクセス許可を設定する

ARO サービス プリンシパルには、新しい Azure ストレージ アカウントのリソース グループに対する 'listKeys' アクセス許可が必要です。 これを実現するには、'共同作成者' ロールを割り当てます。

ARO_RESOURCE_GROUP=aro-rg
CLUSTER=cluster
ARO_SERVICE_PRINCIPAL_ID=$(az aro show -g $ARO_RESOURCE_GROUP -n $CLUSTER --query servicePrincipalProfile.clientId -o tsv)

az role assignment create --role Contributor --scope /subscriptions/mySubscriptionID/resourceGroups/$AZURE_FILES_RESOURCE_GROUP --assignee $ARO_SERVICE_PRINCIPAL_ID

ARO クラスターのアクセス許可を設定する

OpenShift 永続ボリュームのバインダー サービス アカウントには、シークレットを読み取る機能が必要です。 これを実現するには、OpenShift クラスターのロールを作成して割り当てます。

ARO_API_SERVER=$(az aro list --query "[?contains(name,'$CLUSTER')].[apiserverProfile.url]" -o tsv)

oc login -u kubeadmin -p $(az aro list-credentials -g $ARO_RESOURCE_GROUP -n $CLUSTER --query=kubeadminPassword -o tsv) $ARO_API_SERVER

oc create clusterrole azure-secret-reader \
	--verb=create,get \
	--resource=secrets

oc adm policy add-cluster-role-to-user azure-secret-reader system:serviceaccount:kube-system:persistent-volume-binder

Azure Files プロビジョナーを使用して StorageClass を作成する

この手順では、Azure Files プロビジョナーを使用して StorageClass を作成します。 ARO クラスターが現在のリソース グループの外部にあるストレージ アカウントを認識できるようにするため、StorageClass マニフェストにストレージ アカウントの詳細を記述する必要があります。

ストレージのプロビジョニング中に、マウント資格情報用に secretName という名前のシークレットが作成されます。 マルチテナントのコンテキストでは、secretNamespace の値を明示的に設定することを強くお勧めします。そうしないと、ストレージ アカウントの資格情報が他のユーザーによって読み取られる可能性があります。

cat << EOF >> azure-storageclass-azure-file.yaml
kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
  name: azure-file
provisioner: file.csi.azure.com
mountOptions:
  - dir_mode=0777
  - file_mode=0777
  - uid=0
  - gid=0
  - mfsymlinks
  - cache=strict
  - actimeo=30
  - noperm
parameters:
  location: $LOCATION
  secretNamespace: kube-system
  skuName: Standard_LRS
  storageAccount: $AZURE_STORAGE_ACCOUNT_NAME
  resourceGroup: $AZURE_FILES_RESOURCE_GROUP
reclaimPolicy: Delete
volumeBindingMode: Immediate
EOF

oc create -f azure-storageclass-azure-file.yaml

Azure Files のマウント オプションは通常、デプロイするワークロードと、アプリケーションの要件によって異なります。 特に Azure ファイルの場合、使用を検討する必要があるパラメーターが他にもあります。

必須のパラメーター:

• クライアントで使用できるフォームにシンボリック リンクをマップする "mfsymlinks"
• クライアント側でアクセス許可チェックを無効にする "noperm"

推奨されるパラメーター:

• クライアントが既存のマウント ポイント経由で既に接続されている場合に、ソケットの再使用を無効にする "nossharesock"
• CIFS クライアントでファイル属性とディレクトリ属性をキャッシュする時間を長くする "actimeo=30" (またはそれ以上)
• posix ロックに問題があるアプリケーションのための "nobrl"。これはまた、サーバーへのバイト範囲ロック要求の送信を無効にします

既定の StorageClass を変更する (省略可能)

ARO の既定の StorageClass は、マネージド premium と呼ばれ、azure-disk プロビジョナーを使用します。 これを変更するには、StorageClass マニフェストに対して patch コマンドを発行します。

oc patch storageclass managed-premium -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"false"}}}'

oc patch storageclass azure-file -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'

Azure Files StorageClass を検証する (省略可能)

新しいアプリケーションを作成し、それにストレージを登録します。

oc new-project azfiletest
oc new-app httpd-example

#Wait for the pod to become Ready
curl $(oc get route httpd-example -n azfiletest -o jsonpath={.spec.host})

#If you have set the storage class by default, you can omit the --claim-class parameter
oc set volume dc/httpd-example --add --name=v1 -t pvc --claim-size=1G -m /data --claim-class='azure-file'

#Wait for the new deployment to rollout
export POD=$(oc get pods --field-selector=status.phase==Running -o jsonpath={.items[].metadata.name})
oc exec $POD -- bash -c "echo 'azure file storage' >> /data/test.txt"

oc exec $POD -- bash -c "cat /data/test.txt"
azure file storage

test.txt ファイルは、Azure portal の Storage Explorer でも表示されます。

次のステップ

この記事では、Microsoft Azure Files と Azure Red Hat OpenShift 4 を使用して、動的な永続ストレージを作成しました。 以下の方法を学習しました。

次の記事に進んで、Azure Red Hat OpenShift 4 でサポートされているリソースについて確認してください。

• Azure Red Hat OpenShift のサポート ポリシー