• 要件
• デザインの選択
• 設定
  • インストールコマンドラインオプション
• チャート構成例
  • エクストラエンバイロメント
  • 画像.pullSecrets
  • こうわん
  • コンメンタール
  • 優先クラス名
• 外部サービス
  • ワークホース
• チャート設定
  • gitリポジトリの永続性
  • TLSでGitalyを動かす

GitLab-Gitalyチャートの使い方

gitaly サブチャートでは、Gitalyサーバーのデプロイを設定することができます。

要件

このチャートは、GitLabチャートの一部として、またはこのチャートがデプロイされているKubernetesクラスターからアクセス可能な外部サービスとして提供されているWorkhorseサービスへのアクセスに依存しています。

デザインの選択

このチャートで使っているGitalyコンテナには、GitLab Shellのコードベースも含まれています。GitalyコンテナにはGitLab Shellコンテナのコピーも含まれているので、このチャートでGitLab Shellを設定する必要があります。

設定

gitaly Chartは、外部サービスとチャート設定の2つの部分で構成されます。

GitalyはデフォルトではGitLabチャートをデプロイする際にコンポーネントとしてデプロイされます。 Gitalyを個別にデプロイする場合は、global.gitaly.enabled をfalse に設定し、外部のGitalyドキュメントに記載されているように追加の設定を行う必要があります。

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

以下の表は、--set フラグを使用して、helm install コマンドに供給できるすべての可能なチャート設定です。

チャート構成例

エクストラエンバイロメント

extraEnv を使用すると、ポッド内のすべてのコンテナで追加の環境変数を公開できます。

以下はextraEnvの使用例です：

extraEnv:
  SOME_KEY: some_value
  SOME_OTHER_KEY: some_other_value

コンテナを起動すると、環境変数が公開されていることを確認できます：

env | grep SOME
SOME_KEY=some_value
SOME_OTHER_KEY=some_other_value

画像.pullSecrets

pullSecrets を使うと、非公開レジストリで認証してポッドのイメージを取り出せるようになります。

非公開レジストリとその認証方法についての詳細は、Kubernetesのドキュメントに記載されています。

以下はpullSecrets

image:
  repository: my.gitaly.repository
  tag: latest
  pullPolicy: Always
  pullSecrets:
  - name: my-secret-name
  - name: my-secondary-secret-name

こうわん

tolerations 汚染されたワーカーノードでポッドのスケジューリングが可能

以下はtolerationsの使用例です：

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

コンメンタール

annotations は、Gitalyポッドに注釈を追加することができます。

以下はannotationsの使用例です：

annotations:
  kubernetes.io/example-annotation: annotation-value

優先クラス名

priorityClassName では、GitalyポッドにPriorityClassを割り当てることができます。

以下はpriorityClassNameの使用例です：

priorityClassName: persistence-enabled

外部サービス

このChartはWorkhorseのサービスに添付されているはずです。

ワークホース

workhorse:
  host: workhorse.example.com
  serviceName: webservice
  port: 8181

チャート設定

以下の値は、Gitalyポッドの設定に使用されます。

gitリポジトリの永続性

このチャートは、PersistentVolumeClaimをプロビジョニングし、対応する永続ボリュームをGitリポジトリデータ用にマウントします。 これを動作させるには、Kubernetesクラスターで利用可能な物理ストレージが必要です。 emptyDirを使いたい場合は、persistence.enabled: falseでPersistentVolumeClaimを無効にしてください。

persistence:
  enabled: true
  storageClass: standard
  accessMode: ReadWriteOnce
  size: 50Gi
  matchLabels: {}
  matchExpressions: []
  subPath: "/data"
  annotations: {}

TLSでGitalyを動かす

Gitalyは、TLSを介した他のコンポーネントとの通信をサポートしています。 これは、global.gitaly.tls.enabled とglobal.gitaly.tls.secretNameの設定によって制御されます。 TLSを介してGitalyを実行するための手順に従ってください：

1. Chartは、GitalyとTLSで通信するために証明書が提供されることを期待します。 この証明書は、存在するすべてのGitalyノードに適用されるべきです。 したがって、これらのGitalyノードのそれぞれのすべてのホスト名は、証明書のサブジェクト代替名(SAN) として追加されるべきです。

   使用するホスト名を知るには、task-runnerポッドの/srv/gitlab/config/gitlab.ymlファイルをチェックし、その中のrepositories.storages キーの下に指定されているさまざまなgitaly_address フィールドをチェックします。

   kubectl exec -it <task-runner pod> -- grep gitaly_address /srv/gitlab/config/gitlab.yml
   

1. 作成した証明書を使ってk8s TLSシークレットを作成します。

   kubectl create secret tls gitaly-server-tls --cert=gitaly.crt --key=gitaly.key
   

2. 引数を渡してHelmチャートを再デプロイします。--set global.gitaly.tls.enabled=true --set global.gitaly.tls.secretName=<secret name>