Helm Chart

K2HR3 Helm Chartは、kubernetes環境に Helm（Kubernetes用パッケージマネージャー） を使って K2HR3システム を構築するための Helm Chart です。

概要

K2HR3 Helm Chart を使うことで、簡単にkubernetes環境へK2HR3システムの構築ができます。

K2HR3 Helm Chart は、Helm（Kubernetes用パッケージマネージャー）に対応した Helm Chartです。
K2HR3 Helm Chart は、Chartリポジトリを K2HR3 Helm Chart repository で公開し、Artifact Hub に登録しています。

Helmコマンド を使って、Artifact Hub で公開されている K2HR3 Helm Chartをリポジトリとしてロードし、簡単にK2HR3システムの構築ができます。

K2HR3 Helm Chartのソースコードは、k2hr3_helm_chart - Githubで公開されています。

RANCHER対応

K2HR3 Helm Chartは、RANCHER Helm Chart として利用できます。
RANCHERのリポジトリに登録し、K2HR3システムを簡単に構築できます。
RANCHERからの利用方法は、こちらを参照してください。

Helmについて

K2HR3 Helm Chartは、Helm（Kubernetes用パッケージマネージャー）が利用する Helm Chart です。

K2HR3 Helm Chartは、Artifact Hub で公開されており、どこからでも利用できます。

Helmの使い方については、こちらを参照してください。

Helmコマンドを使い、K2HR3 Helm ChartからK2HR3システムを構築する方法は、こちらを参照してください。

K2HR3 Helm Chart オプション

K2HR3 Helm Chart を Helm（Kubernetes用パッケージマネージャー）を使い、インストール（helm install）するときに、オプションを指定できます。

以下に、K2HR3 Helm Chart が提供するオプションの一覧を以下に示します。

各々のオプションの説明をします。

nameOverride

fullnameOverrideオプションが指定されていない場合、完全な名前のリリース部分をオーバーライドします。
本オプションを省略した場合、k2hr3をデフォルト値として使います。

fullnameOverride

Chartのリリース名を（上書き）指定します。
本オプションを省略した場合、未指定（空文字列）となります。

serviceAccount.create

kubernetesのサービスアカウントを作成するかどうかを指定します。
本オプションを省略した場合、trueをデフォルト値として使います。

serviceAccount.annotations

kubernetesサービスアカウントを作成する場合、そのサービスアカウントに設定するannotationsをオブジェクトで指定します。
本オプションを省略した場合、{}（空オブジェクト）をデフォルト値として使います。

serviceAccount.name

kubernetesサービスアカウントを作成する場合、そのサービスアカウント名を指定します。この値が空の場合、サービスアカウントは作成されません。
本オプションを省略した場合、未指定（空文字列）となります。

antpickax.configDir

K2HR3システムで使用するコンフィグレーションファイルのあるディレクトリパスを指定します。
本オプションを省略した場合、/etc/antpickax をデフォルト値として使います。

antpickax.certPeriodYear

K2HR3システム内部で作成し、利用するTLS自己署名証明書（CA証明書含む）の有効期間（年）を指定します。
本オプションを省略した場合、5（年） をデフォルト値として使います。

minikube

minikube環境に構築する場合には、このオプションにtrueを指定します。
本オプションを省略した場合、false をデフォルト値として使い、minikube環境ではないものとしてインストールが実行されます。

k2hr3.clusterName

K2HR3システムのクラスター名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、クラスター名は Helm Chartの リリース名（.Release.Name）が使われます。

k2hr3.startManual

K2HR3システムを構築するときに、各K2HR3システムコンポーネント（K2HR3 Web Appilcation / K2HR3 REST API）を手動で起動するか否かを指定します。
本オプションを省略した場合、falseとなり、自動で構築されます。
このオプションは、開発者向けのオプションです。

k2hr3.baseDomain

K2HR3システムのkubernetesクラスター内でのベースドメイン名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 k8s.domain の値が使用されます。

k2hr3.dkc.baseName

K2HR3システムのバックエンドとして構築されるK2HDKCクラスターのベース名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 r3dkc が使用されます。

k2hr3.dkc.count

K2HR3システムのバックエンドとして構築されるK2HDKCクラスターのサーバ数を指定します。
本オプションを省略した場合、サーバー数は2となります。

k2hr3.api.baseName

K2HR3システムのREST APIサーバーのベース名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 r3api が使用されます。

k2hr3.api.count

K2HR3システムのREST APIのサーバ数を指定します。
本オプションを省略した場合、サーバー数は2となります。

k2hr3.api.extHostname

K2HR3システムのREST APIサーバーのkubernetesクラスター外部からのアクセスするためのホスト名（FQDN）を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 kubernetes内部で使用されるホスト名（FQDN）が使用されます。
本オプションには、K2HR3システムがkubernetesクラスター内に構築された場合の NodePortへアクセスできるホスト名（主にNodeホスト名）を指定してください。
minikubeを利用している場合、minikubeを起動したホスト名を指定するようにしてください。

k2hr3.api.extPort

K2HR3システムのREST APIサーバーのkubernetesクラスター外部からのアクセスするためのポート番号を指定します。
本オプションを省略した場合、未指定（0）となり、31443 ポートが使用されます。

k2hr3.api.customConf

K2HR3システムのREST APIサーバーの設定ファイルの一つである local.json ファイルの中身を指定でき、デフォルトの設定値を上書きすることができます。
値は、JSON String 形式で指定します。
本オプションを省略した場合、local.json ファイルは未設定となります。

k2hr3.api.localTenant

K2HR3システムのREST APIサーバーが、LOCAL TENANTをサポートするか否か指定できます。

k2hr3.app.baseName

K2HR3システムのWeb Applicationサーバーのベース名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 r3app が使用されます。

k2hr3.app.count

K2HR3システムのWeb Applicationのサーバ数を指定します。
本オプションを省略した場合、サーバー数は2となります。

k2hr3.app.extHostname

K2HR3システムのWeb Applicationサーバーのkubernetesクラスター外部からのアクセスするためのホスト名（FQDN）を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 kubernetes内部で使用されるホスト名（FQDN）が使用されます。
本オプションには、K2HR3システムがkubernetesクラスター内に構築された場合の NodePortへアクセスできるホスト名（主にNodeホスト名）を指定してください。
minikubeを利用している場合、minikubeを起動したホスト名を指定するようにしてください。

k2hr3.app.extPort

K2HR3システムのWeb Applicationサーバーのkubernetesクラスター外部からのアクセスするためのポート番号を指定します。
本オプションを省略した場合、未指定（0）となり、32443 ポートが使用されます。

k2hr3.app.customConf

K2HR3システムのWeb Applicationサーバーの設定ファイルの一つである local.json ファイルの中身を指定でき、デフォルトの設定値を上書きすることができます。
値は、JSON String 形式で指定します。
本オプションを省略した場合、local.json ファイルは未設定となります。

k2hr3.app.localTenant

K2HR3システムのWeb Applicationサーバーが、LOCAL TENANTをサポートするか否か指定できます。

k2hr3.env.httpProxy

K2HR3システムの各K2HR3システムコンポーネント（K2HR3 Web Appilcation / K2HR3 REST API / K2HDKCクラスター）にPROXY設定としてHTTP_PROXY環境変数を設定します。
本オプションを省略した場合、未指定（空文字列）となり、 HTTP_PROXY 環境変数は設定されません。

k2hr3.env.httpsProxy

K2HR3システムの各K2HR3システムコンポーネント（K2HR3 Web Appilcation / K2HR3 REST API / K2HDKCクラスター）にPROXY設定としてHTTPS_PROXY環境変数を設定します。
本オプションを省略した場合、未指定（空文字列）となり、 HTTPS_PROXY 環境変数は設定されません。

k2hr3.env.noProxy

K2HR3システムの各K2HR3システムコンポーネント（K2HR3 Web Appilcation / K2HR3 REST API / K2HDKCクラスター）にPROXY設定としてNO_PROXY環境変数を設定します。
本オプションを省略した場合、未指定（空文字列）となり、 NO_PROXY 環境変数は設定されません。

images.app.fullImageName

K2HR3システムのWeb Appilcationサーバーに使用される Dockerイメージ名（オーガナイゼーション名/イメージ名:タグ名）を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 本Helm Chartがリリースされた時点での最新の Dockerイメージ (例：antpickax/k2hr3-app:1.0.17 )が使用されます。
本オプションを指定した場合は、images.app.organization、images.app.imageName および images.app.version を指定できません。

images.app.organization

K2HR3システムのWeb Appilcationサーバーに使用される Dockerイメージ のオーガナイゼーション名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 antpickax が使用されます。
本オプションを指定した場合は、images.app.fullImageName を指定できません。

images.app.imageName

K2HR3システムのWeb Appilcationサーバーに使用される Dockerイメージ のイメージ名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 k2hr3-app が使用されます。
本オプションを指定した場合は、images.app.fullImageName を指定できません。

images.app.version

K2HR3システムのWeb Appilcationサーバーに使用される Dockerイメージ のタグ名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 本Helm Chartがリリースされた時点での最新の antpickax/k2hr3-app イメージの最新タグ名 (例：1.0.17 )が使用されます。
本オプションを指定した場合は、images.app.fullImageName を指定できません。

images.api.fullImageName

K2HR3システムのREST APIサーバーに使用される Dockerイメージ名（オーガナイゼーション名/イメージ名:タグ名）を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 本Helm Chartがリリースされた時点での最新の Dockerイメージ (例：antpickax/k2hr3-api:1.0.21 )が使用されます。
本オプションを指定した場合は、images.api.organization、images.api.imageName および images.api.version を指定できません。

images.api.organization

K2HR3システムのREST APIサーバーに使用される Dockerイメージ のオーガナイゼーション名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 antpickax が使用されます。
本オプションを指定した場合は、images.api.fullImageName を指定できません。

images.api.imageName

K2HR3システムのREST APIサーバーに使用される Dockerイメージ のイメージ名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 k2hr3-api が使用されます。
本オプションを指定した場合は、images.api.fullImageName を指定できません。

images.api.version

K2HR3システムのREST APIサーバーに使用される Dockerイメージ のタグ名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 本Helm Chartがリリースされた時点での最新の antpickax/k2hr3-api イメージの最新タグ名 (例：1.0.21 )が使用されます。
本オプションを指定した場合は、images.api.fullImageName を指定できません。

images.dkc.fullImageName

K2HR3システムのK2HDKCクラスターに使用される Dockerイメージ名（オーガナイゼーション名/イメージ名:タグ名）を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 本Helm Chartがリリースされた時点での最新の Dockerイメージ (例：antpickax/k2hdkc:1.0.6 )が使用されます。
本オプションを指定した場合は、images.dkc.organization、images.dkc.imageName および images.dkc.version を指定できません。

images.dkc.organization

K2HR3システムのK2HDKCクラスターに使用される Dockerイメージ のオーガナイゼーション名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 antpickax が使用されます。
本オプションを指定した場合は、images.dkc.fullImageName を指定できません。

images.dkc.imageName

K2HR3システムのK2HDKCクラスターに使用される Dockerイメージ のイメージ名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 k2hdkc が使用されます。
本オプションを指定した場合は、images.dkc.fullImageName を指定できません。

images.dkc.version

K2HR3システムのK2HDKCクラスターに使用される Dockerイメージ のタグ名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 本Helm Chartがリリースされた時点での最新の antpickax/k2hdkc イメージの最新タグ名 (例：1.0.6 )が使用されます。
本オプションを指定した場合は、images.dkc.fullImageName を指定できません。

images.chmpx.fullImageName

K2HR3システムのK2HDKCクラスターおよびREST APIサーバーが利用するCHMPXプロセスに使用される Dockerイメージ名（オーガナイゼーション名/イメージ名:タグ名）を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 本Helm Chartがリリースされた時点での最新の Dockerイメージ (例：antpickax/chmpx:1.0.99 )が使用されます。
本オプションを指定した場合は、images.chmpx.organization、images.chmpx.imageName および images.chmpx.version を指定できません。

images.chmpx.organization

K2HR3システムのK2HDKCクラスターおよびREST APIサーバーが利用するCHMPXプロセスに使用される Dockerイメージ のオーガナイゼーション名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 antpickax が使用されます。
本オプションを指定した場合は、images.chmpx.fullImageName を指定できません。

images.chmpx.imageName

K2HR3システムのK2HDKCクラスターおよびREST APIサーバーが利用するCHMPXプロセスに使用される Dockerイメージ のイメージ名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 chmpx が使用されます。
本オプションを指定した場合は、images.chmpx.fullImageName を指定できません。

images.chmpx.version

K2HR3システムのK2HDKCクラスターおよびREST APIサーバーが利用するCHMPXプロセスに使用される Dockerイメージ のタグ名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 本Helm Chartがリリースされた時点での最新の antpickax/chmpx イメージの最新タグ名 (例：1.0.99 )が使用されます。
本オプションを指定した場合は、images.chmpx.fullImageName を指定できません。

images.init.fullImageName

K2HR3システムの各K2HR3システムコンポーネント（K2HR3 Web Appilcation / K2HR3 REST API / K2HDKCクラスター）の初期化用コンテナーで使用される Dockerイメージ名（オーガナイゼーション名/イメージ名:タグ名）を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 本Helm Chartがリリースされた時点での最新の Dockerイメージ (例：alpine:3.17.3 )が使用されます。
本オプションを指定した場合は、images.init.organization、images.init.imageName および images.init.version を指定できません。

images.init.organization

K2HR3システムの各K2HR3システムコンポーネント（K2HR3 Web Appilcation / K2HR3 REST API / K2HDKCクラスター）の初期化用コンテナーで使用される Dockerイメージ のオーガナイゼーション名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 未設定となります。
本オプションを指定した場合は、images.init.fullImageName を指定できません。

images.init.imageName

K2HR3システムの各K2HR3システムコンポーネント（K2HR3 Web Appilcation / K2HR3 REST API / K2HDKCクラスター）の初期化用コンテナーで使用される Dockerイメージ のイメージ名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 alpine が使用されます。
本オプションを指定した場合は、images.init.fullImageName を指定できません。

images.init.version

K2HR3システムの各K2HR3システムコンポーネント（K2HR3 Web Appilcation / K2HR3 REST API / K2HDKCクラスター）の初期化用コンテナーで使用される Dockerイメージ のタグ名を指定します。
本オプションを省略した場合、未指定（空文字列）となり、 本Helm Chartがリリースされた時点での最新の alpine イメージの最新タグ名 (例：3.17.3 )が使用されます。
本オプションを指定した場合は、images.init.fullImageName を指定できません。

mountPoint.configMap

構築するK2HR3システムの各コンテナーが利用する configMapをマウントするディレクトリパスを指定します。
本オプションを省略した場合、/configmap が使用されます。

mountPoint.ca

構築するK2HR3システムで使用する自己署名CA証明書とその秘密鍵を保管するディレクトリパスを指定します。
本オプションを省略した場合、/secret-ca が使用されます。

k8s.namespace

K2HR3システムを構築するkubernetesクラスターで使用する namespace（名前空間） を指定します。
本オプションを省略した場合、未指定（空文字列）となり、.Release.Namespace が使われます。

k8s.domain

K2HR3システムを構築するkubernetesクラスターのドメイン名を指定します。
本オプションを省略した場合、svc.cluster.local が使用されます。

k8s.caCert

K2HR3システムを構築するkubernetesクラスターのCA証明書のファイルパスを指定します。
本オプションを省略した場合、/var/run/secrets/kubernetes.io/serviceaccount/ca.crt が使用されます。

k8s.saToken

K2HR3システムを構築するkubernetesクラスターのサービスアカウントのトークンファイルパスを指定します。
本オプションを省略した場合、/var/run/secrets/kubernetes.io/serviceaccount/token が使用されます。

k8s.apiUrl

K2HR3システムを構築するkubernetesクラスターのAPIエンドポイントを指定します。
本オプションを省略した場合、https://kubernetes.default.svc が使用されます。

oidc.clientId [必須]

構築するK2HR3システムの認証で使う OpenID Connect（OIDC）のクライアントID（Client ID）を指定します。
このオプションは必須であり、省略はできません。
このHelm Chartで構築されるK2HR3システムは、OpenID Connect（OIDC）による認証を行うことを前提としていますので、このオプションは必ず指定しなくてはなりません。

oidc.clientSecret [必須]

構築するK2HR3システムの認証で使う OpenID Connect（OIDC）の Secret を指定します。
このオプションは必須であり、省略はできません。
このHelm Chartで構築されるK2HR3システムは、OpenID Connect（OIDC）による認証を行うことを前提としていますので、このオプションは必ず指定しなくてはなりません。

oidc.cookieExpire [必須]

構築するK2HR3システムの認証で使う OpenID Connect（OIDC）の Cookie有効期限 を指定します。
このオプションは必須であり、省略はできません。
このHelm Chartで構築されるK2HR3システムは、OpenID Connect（OIDC）による認証を行うことを前提としていますので、このオプションは必ず指定しなくてはなりません。

oidc.cookieName [必須]

構築するK2HR3システムの認証で使う OpenID Connect（OIDC）の Cookie名を指定します。
このオプションは必須であり、省略はできません。
このHelm Chartで構築されるK2HR3システムは、OpenID Connect（OIDC）による認証を行うことを前提としていますので、このオプションは必ず指定しなくてはなりません。

oidc.issuerUrl [必須]

構築するK2HR3システムの認証で使う OpenID Connect（OIDC）の発行者URL（Issure URL）を指定します。
このオプションは必須であり、省略はできません。
このHelm Chartで構築されるK2HR3システムは、OpenID Connect（OIDC）による認証を行うことを前提としていますので、このオプションは必ず指定しなくてはなりません。

oidc.usernameKey

構築するK2HR3システムの認証で使う OpenID Connect（OIDC）にユーザ名が実装されている場合、そのユーザ名を示すキー名を指定します。
このオプションは省略でき、省略された場合、ユーザ名を示すキーは存在しないものとしてK2HR3システムは動作します。

unconvertedFiles.k2hr3

構築するK2HR3システムが使う configMapに登録するファイル（加工なし）を指定します。
通常、この値を変更する必要はなく、省略することができます。
省略した場合には、このHelm Chartの持つ files ディレクトリ以下のファイルが configMap として配置されます。

convertedFiles.k2hr3

構築するK2HR3システムが使う configMapに登録するファイル（加工あり）を指定します。
通常、この値を変更する必要はなく、省略することができます。
省略した場合には、このHelm Chartの持つ files ディレクトリ以下のファイルが configMap として配置されます。