1. Oracle Identity Governance on Kubernetesのデプロイおよび管理
  2. Oracle Identity Governance on Kubernetesのインストール
  3. Oracle Identity Governanceドメインの作成
  4. WLSTオフライン・スクリプトを使用したOIGドメインの作成
  5. ドメイン作成スクリプトの準備

7.1.5 ドメイン作成スクリプトの準備

Oracle Identity Governance (OIG)ドメイン・デプロイメントのサンプル・スクリプトは、$WORKDIR/kubernetes/create-oim-domainディレクトリにあります。OIGをデプロイする前にスクリプトを準備する必要があります。

  1. $WORKDIR/kubernetes/create-oim-domain/domain-home-on-pvディレクトリに移動します:
    cd $WORKDIR/kubernetes/create-oim-domain/domain-home-on-pv
  2. create-domain-inputs.yamlファイルのコピーを作成します:
    cp create-domain-inputs.yaml create-domain-inputs.yaml.orig
  3. create-domain-inputs.yamlを編集し、次のパラメータを変更します。完了後、ファイルを保存します:
    domainUID: <domain_uid>
domainHome: /u01/oracle/user_projects/domains/<domain_uid>
image: <image_name>
imagePullSecretName: <container_registry_secret>
weblogicCredentialsSecretName: <kubernetes_domain_secret>
logHome: /u01/oracle/user_projects/domains/logs/<domain_id>
namespace: <domain_namespace>
persistentVolumeClaimName: <pvc_name>
rcuSchemaPrefix: <rcu_prefix>
rcuDatabaseURL: <rcu_db_host>:<rcu_db_port>/<rcu_db_service_name>
rcuCredentialsSecret: <kubernetes_rcu_secret>
frontEndHost: <front_end_hostname>
frontEndPort: <front_end_port>
    例:
    domainUID: governancedomain
domainHome: /u01/oracle/user_projects/domains/governancedomain
image: container-registry.oracle.com/middleware/oig_cpu:14.1.2.1.0-jdk8-ol8-<YYMMDD>
imagePullSecretName: orclcred
weblogicCredentialsSecretName: oig-domain-credentials
logHome: /u01/oracle/user_projects/domains/logs/governancedomain
namespace: oigns
persistentVolumeClaimName: governancedomain-domain-pvc
rcuSchemaPrefix: OIGK8S
rcuDatabaseURL: mydatabasehost.example.com:1521/orcl.example.com
rcuCredentialsSecret: oig-rcu-credentials
frontEndHost: example.com
frontEndPort: 14100

    ノート:

    この時点では、frontEndHostおよびfrontEndPortをそれぞれexample.comおよび14100に設定する必要があります。これらの値は、「MBeanを使用したOIMFrontendURLの設定」のインストール後のタスクで正しい値に変更されます。
次に、create-domain-inputs.yamlファイルのパラメータの完全なリストを示します:
パラメータ 定義 デフォルト
adminPort Kubernetesクラスタ内の管理サーバーのポート番号。 7001
adminNodePort Kubernetesクラスタ外部の管理サーバーのポート番号。 30701
adminServerName 管理サーバーの名前。 AdminServer
clusterName ドメイン用に生成するWebLogicクラスタ・インスタンスの名前。デフォルトでは、oigドメイン用のクラスタ名はoim_clusterです。 oim_cluster
configuredManagedServerCount ドメインに対して生成する管理対象サーバー・インスタンスの数。 5
createDomainFilesDir createDomainScriptNameプロパティで指定されたスクリプトを含め、WebLogicドメインを作成するためのすべてのファイルを検索するホスト・マシン上のディレクトリ。デフォルトでは、このディレクトリは相対パスwlstに設定され、作成スクリプトは、wlstディレクトリの組込みWLSTオフライン・スクリプトを使用してWebLogicドメインを作成します。これは相対パスwdtに設定することもできます。その後、組込みWDTスクリプトがかわりに使用されます。絶対パスも、ファイル・システム内の任意のディレクトリを指すようにサポートされています。組込みスクリプトは、ファイルが指定されたディレクトリにあるかぎり、ユーザーが指定したスクリプトまたはモデル・ファイルに置き換えることができます。このディレクトリ内のファイルは、Kubernetes構成マップに配置され、さらにcreateDomainScriptsMountPathにマウントされます。これにより、Kubernetesポッドがスクリプトおよびサポート・ファイルを使用してドメイン・ホームを作成できるようになります。 wlst
createDomainScriptsMountPath ドメイン作成スクリプトがポッド内にあるマウント・パス。create-domain.shスクリプトは、ドメイン・ホームを作成するKubernetesポッドでスクリプト(createDomainScriptNameプロパティで指定)を実行するKubernetesジョブを作成します。createDomainFilesDirディレクトリ内のファイルはポッドのこの場所にマウントされるため、Kubernetesポッドはスクリプトおよびサポート・ファイルを使用してドメイン・ホームを作成できます。 /u01/weblogic
createDomainScriptName ドメイン作成スクリプトがWebLogicドメインの作成に使用するスクリプト。create-domain.shスクリプトは、ドメイン・ホームを作成するこのスクリプトを実行するKubernetesジョブを作成します。このスクリプトは、createDomainScriptsMountPathプロパティで指定されたポッド内のディレクトリにあります。組込みスクリプトを使用するかわりに、ドメイン・ホームを作成するための独自のスクリプトを指定する必要がある場合は、このプロパティを使用して、ドメイン作成ジョブで実行するスクリプトの名前を設定する必要があります。 create-domain-job.sh
domainHome OIGドメインのホーム・ディレクトリ。指定しない場合、値はdomainUIDから/shared/domains/<domainUID>として導出されます。 /u01/oracle/user_projects/domains/governancedomain
domainPVMountPath ドメイン永続ボリュームのマウント・パス。 /u01/oracle/user_projects/domains
domainUID この特定のドメインの識別に使用される一意のID。生成されたWebLogicドメインの名前およびKubernetesドメイン・リソースの名前として使用されます。このIDは、Kubernetesクラスタ内のすべてのドメインで一意である必要があります。このIDには、Kubernetesサービス名で有効ではない文字を含めることはできません。 governancedomain
exposeAdminNodePort 管理サーバーがKubernetesクラスタの外部に公開されているかどうかを示すブール。 false
exposeAdminT3Channel T3管理チャネルがKubernetesクラスタの外部に公開されているかどうかを示すブール。 true
image OIGコンテナ・イメージ。オペレータにはOIG 14.1.2が必要です。イメージを取得または作成する方法の詳細は、「OIGコンテナ・イメージの取得」を参照してください。 oracle/oig:14.1.2.1.0
imagePullPolicy WebLogicコンテナ・イメージ・プル・ポリシー。有効な値は、IfNotPresent、AlwaysまたはNeverです IfNotPresent
imagePullSecretName コンテナ・レジストリにアクセスしてOIGコンテナ・イメージをプルするためのKubernetesシークレットの名前。このパラメータを指定すると、シークレットの存在が検証されます。 orclcred
includeServerOutInPodLog ポッドのstdoutにserver.outを含めるかどうかを示すブール。 true
initialManagedServerReplicas ドメインで最初に起動する管理対象サーバーの数。 2
javaOptions 管理サーバーおよび管理対象サーバーを起動するためのJavaオプション。Javaオプションには、WebLogicドメイン情報を取得するための事前定義された次の1つ以上の変数への参照を含めることができます: $(DOMAIN_NAME)、$(DOMAIN_HOME)、$(ADMIN_NAME)、$(ADMIN_PORT)および$(SERVER_NAME)。 -Dweblogic.StdoutDebugEnabled=false
logHome ドメイン・ログ、サーバー・ログ、サーバー出力およびノード・マネージャ・ログ・ファイルのポッド内の場所。指定しない場合、値はdomainUIDから/shared/logs/<domainUID>として導出されます。 /u01/oracle/user_projects/domains/logs/governancedomain
managedServerNameBase 管理対象サーバー名の生成に使用されるベース文字列。 oim_server
managedServerPort 各管理対象サーバーのポート番号。 14000
namespace ドメインを作成するKubernetesネームスペース。 oigns
persistentVolumeClaimName ドメイン・ホームをホストするために作成された永続ボリューム要求の名前。指定しない場合、値はdomainUIDから<domainUID>-weblogic-sample-pvcとして導出されます。 governancedomain-domain-pvc
productionModeEnabled ドメインで本番モードが有効かどうかを示すブール。 true
serverStartPolicy 起動するWebLogic Serverインスタンスを決定します。有効な値は、Never、IfNeeded、AdminOnlyです。 IfNeeded
t3ChannelPort NetworkAccessPointのT3チャネルのポート。 30012
t3PublicAddress T3チャネルのパブリック・アドレス。これは、Kubernetesクラスタのパブリック・アドレスに設定する必要があります。これは通常、ロード・バランサのアドレスになります。開発環境の場合のみ: 単一サーバー(オールインワン)のKubernetesデプロイメントでは、これはマスターのアドレスに設定できますが、少なくともいずれかのワーカー・ノードのアドレスに設定する必要があります。 指定しない場合、スクリプトはこれをKubernetesクラスタのIPアドレスに設定しようとします
weblogicCredentialsSecretName 管理サーバーのユーザー名とパスワードのKubernetesシークレットの名前。指定しない場合、値はdomainUIDから<domainUID>-weblogic-credentialsとして導出されます。 oig-domain-credentials
weblogicImagePullSecretName WebLogic Serverイメージをプルするために使用される、コンテナ・レジストリのKubernetesシークレットの名前。  
serverPodCpuRequest、serverPodMemoryRequest、serverPodCpuCLimit、serverPodMemoryLimit サーバー・ポッドごとに許可されるコンピュート・リソースの最大量および必要なコンピュート・リソースの最小量。詳細は、コンテナのコンピュート・リソースの管理に関するKubernetesドキュメントを参照してください。 リソース・リクエストおよびリソース制限は指定されていません。
rcuSchemaPrefix データベースで使用するスキーマ接頭辞(OIGK8Sなど)。RCUスキーマとの一致ドメインを簡略化するために、これをdomainUIDと同じにできます。

ノート:

RCUスキーマ接頭辞に使用できるのは、英数字のみで、スペースやその他の特殊文字は使用できません。これは文字で始まり、8文字以内である必要があります。
OIGK8S
rcuDatabaseURL データベースURL。 oracle-db.default.svc.cluster.local:1521/devpdb.k8s
rcuCredentialsSecret データベース資格証明を含むKubernetesシークレット。 oig-rcu-credentials
frontEndHost OIGのエントリ・ポイントURL。 未設定
frontEndPort OIFのエントリ・ポイント・ポート。 未設定
datasourceType OIGドメインに適用可能なJDBCデータソースのタイプ。有効な値は、aglおよびgenericです。Active GridLinkデータソースの場合はaglを選択し、汎用データソースの場合はgenericを選択します。エンタープライズ・デプロイメントでは、Oracle RACデータベースへの接続にGridLinkデータ・ソースを使用することをお薦めします。詳細は、『Kubernetesクラスタ内のOracle Identity and Access Managementのためのエンタープライズ・デプロイメント・ガイド』を参照してください。 generic

ノート:

生成されたYAMLファイル内のKubernetesリソースの名前は、create-domain-inputs.yamlファイルに指定された一部のプロパティの値で構成される可能性があります。これらのプロパティには、adminServerName、clusterNameおよびmanagedServerNameBaseが含まれます。これらの値にKubernetesサービス名で無効な文字が含まれている場合、それらの文字は生成されたYAMLファイルで有効な値に変換されます。たとえば、大文字は小文字に変換され、アンダースコア("_")はハイフン("-")に変換されます。

サンプルでは、1つのクラスタのみを持つドメインに対して、OIGドメイン・ホームおよび関連するKubernetesリソースを作成する方法を示します。また、このサンプルでは、他のユース・ケース用にドメイン・ホームを作成するためのユーザー独自のスクリプトを提供する機能も示します。生成されたドメインYAMLファイルも、より多くのユース・ケースに対応するように変更できます。