オブジェクトストレージにMinIOを使用する

このチャートは、stable/minioバージョン0.4.3に基づいており、ほとんどの設定をそこから継承します。

設計の選択

アップストリームチャートに関連する設計上の選択については、プロジェクトのReadmeに記載されています。

GitLabは、シークレットの設定を簡素化し、環境変数でのシークレットの使用をすべて削除するために、そのチャートを変更することを選択しました。GitLabは、config.jsonにシークレットを入力する処理を制御するためにinitContainerを追加し、チャート全体のenabledフラグを追加しました。

このチャートは、1つのシークレットのみを使用します:

• global.minio.credentials.secret: バケットへの認証に使用されるaccesskey値とsecretkey値を含むグローバルシークレット。

設定

以下に、設定の主要なセクションをすべて説明します。親チャートから設定する場合、これらの値は次のようになります:

minio:
  init:
  ingress:
    enabled:
    apiVersion:
    tls:
      enabled:
      secretName:
    annotations:
    configureCertmanager:
    proxyReadTimeout:
    proxyBodySize:
    proxyBuffering:
  tolerations:
  persistence:  # Upstream
    volumeName:
    matchLabels:
    matchExpressions:
    annotations:
  serviceType:  # Upstream
  servicePort:  # Upstream
  defaultBuckets:
  minioConfig:  # Upstream

コマンドラインオプションのインストール

次の表に、--setフラグを使用してhelm installコマンドに指定できるすべての可能なチャート設定が含まれています:

チャート設定の例

pullSecrets

pullSecretsを使用すると、プライベートレジストリに対して認証を行い、ポッドのイメージをプルできます。

プライベートレジストリとその認証方法の詳細については、Kubernetesドキュメントを参照してください。

pullSecretsの使用例を以下に示します:

image: my.minio.repository
imageTag: latest
imagePullPolicy: Always
pullSecrets:
- name: my-secret-name
- name: my-secondary-secret-name

serviceAccount

このセクションでは、ポッドにデフォルトのServiceAccountアクセストークンをマウントするかどうかを制御します。

tolerations

tolerationsを使用すると、taintedワーカーノードでポッドをスケジュールできます

tolerationsの使用例を以下に示します:

tolerations:
- key: "node_label"
  operator: "Equal"
  value: "true"
  effect: "NoSchedule"
- key: "node_label"
  operator: "Equal"
  value: "true"
  effect: "NoExecute"

サブチャートを有効にする

デプロイで不要なコンポーネントを無効にする機能は、区分化されたサブチャートを実装するために選択した方法に含まれています。このため、最初に決定する必要がある設定はenabled:です。

デフォルトでは、MinIOはすぐに使用できますが、本番環境での使用は推奨されません。無効にする準備ができたら、--set global.minio.enabled: falseを実行します。

initContainerinitContainerを設定します。

めったに変更されませんが、initContainerの動作は次の項目で変更できます:

init:
  image:
    repository:
    tag:
    pullPolicy: IfNotPresent
  script:

InitContainerイメージ

InitContainerイメージ設定は、通常のイメージ設定とまったく同じです。デフォルトでは、チャートローカル値は空のままになり、グローバル設定global.gitlabBase.image.repositoryと現在のglobal.gitlabVersionに関連付けられているイメージタグ付けが、InitContainerイメージの入力に使用されます。グローバル設定は、チャートローカル値（minio.init.image.tagなど）でオーバーライドできます。

InitContainerスクリプト

InitContainerには、次の項目が渡されます:

• /configにマウントされた認証アイテム（通常はaccesskeyとsecretkey）を含むシークレット。
• config.jsonテンプレートを含むConfigMap、および/configにマウントされたshで実行されるスクリプトを含むconfigure。
• デーモンのコンテナに渡される/minioにマウントされたemptyDir。

InitContainerは、/config/configureスクリプトを使用して、完了した設定で/minio/config.jsonを入力することが想定されています。minio-configコンテナがそのタスクを完了すると、/minioディレクトリがminioコンテナに渡され、MinIOサーバーにconfig.jsonを提供するために使用されます。

Ingressの設定

これらの設定は、MinIO Ingressを制御します。

イメージの設定

image、imageTag、およびimagePullPolicyのデフォルトは、アップストリームにドキュメント化されています。

永続

このチャートは、PersistentVolumeClaimをプロビジョニングし、対応する永続ボリュームをデフォルトの場所/exportにマウントします。これが機能するには、Kubernetesクラスタリングで利用可能な物理ストレージが必要です。emptyDirを使用する場合は、persistence.enabled: falseでPersistentVolumeClaimを無効にします。

アップストリームでpersistenceの動作がドキュメント化されています。

GitLabはいくつかの項目を追加しました:

persistence:
  volumeName:
  matchLabels:
  matchExpressions:

defaultBuckets

defaultBucketsは、インストール時にMinIOポッドにバケットを自動的に作成するメカニズムを提供します。このプロパティには、name、policy、およびpurgeの3つまでのプロパティを持つ項目の配列が含まれています。

defaultBuckets:
  - name: public
    policy: public
    purge: true
  - name: private
  - name: public-read
    policy: download

セキュリティコンテキスト

これらのオプションを使用すると、ポッドの起動に使用されるuserやgroupを制御できます。

セキュリティコンテキストの詳細については、公式Kubernetesドキュメントを参照してください。

サービスの種類とポート

これらはアップストリームでドキュメント化されており、主要な概要は次のとおりです:

## Expose the MinIO service to be accessed from outside the cluster (LoadBalancer service).
## or access it from within the cluster (ClusterIP service). Set the service type and the port to serve it.
## ref: http://kubernetes.io/docs/user-guide/services/
##
serviceType: LoadBalancer
servicePort: 9000

チャートはtype: NodePortであるとは想定されていないため、そのように設定しないでください。

アップストリーム項目

次のアップストリームドキュメントも、このチャートに完全に適用されます:

• resources
• nodeSelector
• minioConfig

minioConfig設定の詳細な説明については、MinIO notifyドキュメントを参照してください。これには、バケットオブジェクトにアクセスまたは変更されたときに通知を公開する方法の詳細が含まれます。