8 エンタープライズ・デプロイメント用のソフトウェアの調達
ソフトウェア・ディストリビューション、コンテナ・イメージ、WebLogic Kubernetes Operator、適切なコネクタ・バンドルなどの必要なソフトウェアを調達します。
この章の内容は次のとおりです。
- エンタープライズ・デプロイメント用のソフトウェア・ディストリビューションの特定と取得
エンタープライズ・トポロジのインストールおよび構成を開始する前に、Oracleサポートからコンテナ・イメージをダウンロードする必要があります。 - コンテナ・イメージ名について
コンテナ・イメージの名前は、事前にロードしたか、コンテナ・レジストリからプルしたかによって、固有の形式になります。 - Oracle Container Registryからのソフトウェアの取得
Oracle Container Registryからコンテナ・イメージをダウンロードする前に、まず、サポート資格証明を使用してOracle Container Registryにログインし、デプロイするコンテナごとにライセンス契約に同意する必要があります。 - コンテナ・レジストリからのイメージのダウンロード
コンテナ・レジストリを使用する場合は、オンデマンドまたは事前にレジストリからイメージをプルできます。イメージを事前にプルするとデプロイメントが高速になりますが、そのワーカー・ノードでコンテナを実行しているかどうかに関係なく、すべてのワーカー・ノードで使用できるイメージがあることを意味します。 - コンテナ・イメージのステージング
イメージをコンテナ・レジストリにアップロードする場合、または手動でステージングしたイメージを使用する場合は、それらのイメージをローカル・コンテナ・リポジトリにステージングする必要があります。 - GitHubへのログイン
次の例では、パブリック・リポジトリであるgithub.com
からイメージおよびスクリプトをプルする必要があります。GitHubからイメージを正常にプルするには、リポジトリにログインする必要があります。 - WebLogic Operator for Kubernetesのステージング
WebLogic Operator for Kubernetesを使用して、Oracle Access ManagerまたはOracle Identity Governanceをデプロイします。WebLogic Operatorには、WebLogic Operatorのコンテナ・イメージとWebLogic Operatorのデプロイメント・スクリプトの2つの部分があります。 - コード・リポジトリのステージング
Oracleには、Oracle Identity and Access ManagementをKubernetesにデプロイするためのサンプル・コード・リポジトリが用意されています。このガイドで説明する手順では、多くの場合、サンプル・コード・リポジトリを使用します。構成ホストの一時作業ディレクトリにサンプル・コード・リポジトリをダウンロードします。 - Oracle Identity Governance用のOracle Connectorバンドルのダウンロード
Oracle Identity Governanceと外部システムとの統合を計画している場合は、適切なコネクタ・バンドルをダウンロードする必要があります。エンタープライズ・デプロイメントでは、LDAPコネクタを使用してOracle Unified Directory (OUD)およびOracle Internet Directory (OID)と統合します。
親トピック: エンタープライズ・デプロイメントの準備
エンタープライズ・デプロイメント用のソフトウェア・ディストリビューションの特定と取得
エンタープライズ・トポロジのインストールおよび構成を開始する前に、Oracleサポートからコンテナ・イメージをダウンロードする必要があります。
コンテナ・イメージのダウンロードの詳細は、Oracle Identity and Access Managementのコンテナ・イメージおよびOracle IDMマイクロサービス(ドキュメントID 2723908.1)を参照してください。Oracleは、コンテナ配信をOracle Container Registry (https://container-registry.oracle.com)に移行中です。以降のイメージは、このメカニズムを使用して配信されます。
コンテナ・イメージをダウンロードした後で、それらを各Kubernetesワーカー・ノードでローカルにステージングするか、コンテナ・レジストリでホストできます。コンテナ・レジストリを使用する場合は、「OCIコンテナ・レジストリの使用」を参照してください。
Oracleでは、コンテナ・レジストリを使用してイメージを格納することを強くお薦めします。ただし、各ワーカー・ノードにイメージを手動でロードできます。「コンテナ・イメージのステージング」を参照してください。
ノート:
Oracle Advanced Authenticationを使用している場合は、コンテナ・レジストリを使用する必要があります。コンテナ・レジストリを使用する場合、オンデマンドでイメージを必要なワーカー・ノード(個々の製品の章を参照)にプルするか、デプロイメント内のすべてのKubernetesワーカー・ノードにイメージを事前にプルするかを選択できます。イメージを事前にプルすることを選択した場合は、「コンテナ・レジストリからのイメージのダウンロード」を参照してください。
事前作成済のコンテナ・イメージを取得するには、サポート・ドキュメントのOracle Identity and Access Management 12.2.1.4製品とKubernetesを参照してください。
Oracle HTTP Serverは、Kubernetesクラスタの外部にインストールされます。そのため、従来のソフトウェア・ディストリビューションが必要です。
このガイドで使用されるOracleソフトウェア・ディストリビューション
表8-1に、このガイドで使用されるディストリビューションを示します。
Oracle HTTP Serverソフトウェアの入手方法の一般情報は、『Oracle Fusion Middlewareのインストールのプランニング』の製品ディストリビューションの入手に関する項を参照してください。
特定のOracle Fusion Middleware製品の場所およびダウンロードに関する個別情報は、OTNのOracle Fusion Middlewareのダウンロード、インストールおよび構成のREADMEファイルを参照してください。
ノート:
このガイドの情報は、Oracle Fusion Middleware動作保証マトリクスに記述されている情報を補完するためのものです。このガイドの情報と動作保証マトリクスの情報に相違がある場合は、動作保証マトリクスの情報を適切なバージョンとしてください。動作保証マトリクスのほうが頻繁に更新されています。表8-1 エンタープライズ・デプロイメント・トポロジをインストールおよび構成するためにダウンロードするOracle Fusion Middlewareディストリビューション
ディストリビューション | イメージ名 | タグ/リリース | 説明 |
---|---|---|---|
Oracle HTTP Server 12c |
|
NA |
このディストリビューションをダウンロードして、Web層にOracle HTTP Serverソフトウェアをインストールします。 |
Oracle WebLogic Operator |
|
4.1.8 |
ドメインの構成に使用されるWebLogic Operatorの構成に使用され、必要に応じてRCUを実行します。 |
Oracle Unified Directory 12c |
|
12.2.1.4-jdk8-ol8-<date> |
このバージョン以降をダウンロードして、各Kubernetesワーカー・ノードにインストールするか、コンテナ・レジストリにロードします。 |
Oracle Unified Directory Services Manager |
|
12.2.1.4-jdk8-ol8-<date> |
このバージョン以降をダウンロードして、各Kubernetesワーカー・ノードにインストールするか、コンテナ・レジストリにロードします。 |
Oracle Access Manager 12c |
|
12.2.1.4-jdk8-ol8-<date> |
このバージョン以降をダウンロードして、各Kubernetesワーカー・ノードにインストールするか、コンテナ・レジストリにロードします。 |
Oracle Identity Governance 12c |
|
12.2.1.4-jdk8-ol8-<date> |
このバージョン以降をダウンロードして、各Kubernetesワーカー・ノードにインストールするか、コンテナ・レジストリにロードします。 |
Oracle Identity Role Intelligence |
|
12.2.1.4.<date> |
このバージョン以降をダウンロードして、各Kubernetesワーカー・ノードにインストールするか、コンテナ・レジストリにロードします。 |
Oracle Advanced Authentication |
|
12.2.1.4.1_<date> |
このバージョン以降をダウンロードして、各Kubernetesワーカー・ノードにインストールするか、コンテナ・レジストリにロードします。 |
ノート:
- この表のタグは、基本リリースを示しています。最新のバンドル・パッチを含む最新のイメージを使用する必要があります。タグには、使用しているバージョンが反映されます。例:
12.2.1.4.0-8-ol7-210721.0755
。 - Oracle Advanced Authenticationは、コンテナ・レジストリで使用可能になっている次のイメージにも依存します:
docker.io/library/alpine:latest
container-registry.oracle.com/database/instantclient:12.2.0.1
container-registry.oracle.com/os/oraclelinux:8-slim
- これらのイメージをダウンロードしてタグ付けするコマンドは次のとおりです:
podman pull container-registry.oracle.com/database/instantclient:12.2.0.1
podman tag container-registry.oracle.com/database/instantclient:12.2.0.1 <container_image_registry>/shared/oracle/database-instantclient:12.2.0.1
podman pull container-registry.oracle.com/os/oraclelinux:8-slim
podman tag container-registry.oracle.com/os/oraclelinux:8-slim <container_image_registry>/shared/oracle/linux:8-slim
Dockerを使用している場合は、前述のコマンドでpodman
をdocker
に置き換えます。
親トピック: エンタープライズ・デプロイメント用のソフトウェアの調達
コンテナ・イメージ名について
コンテナ・イメージの名前は、事前にロードしたか、コンテナ・レジストリからプルしたかによって、固有の形式になります。
以降の章では、一部の手順や指示でコンテナ・イメージの名前を指定する必要があります。イメージ名は、コンテナ・レジストリを使用しているか、ローカルでイメージをステージングしているかによって異なります。次の説明では、デプロイメントに使用するコンテナ・イメージ名を判別する方法について説明します。
<REPOSITORY_NAME>/<IMAGE_NAME>:<IMAGE_VERSION>
「コンテナ・イメージのステージング」で説明されているステップを使用してイメージを事前にロードした場合、イメージ名の形式はoracle/oam:12.2.1.4.0-8-ol7-210721.0755
になります。
Oracle Cloud Native Environmentでは、形式はlocalhost/oracle/oam:12.2.1.4.0-8-ol7-210721.0755
です
コンテナ・レジストリからイメージをプルする場合、コンテナ名の前にリポジトリ名が付けられます。レジストリがiad.ocir.io/mytenancy
であるとすると、イメージ名はiad.ocir.io/mytenancy/oracle/oam:12.2.1.4.0-8-ol7-210721.0755
になります。
docker images
sudo podman images
親トピック: エンタープライズ・デプロイメント用のソフトウェアの調達
Oracle Container Registryからのソフトウェアの取得
Oracle Container Registryからコンテナ・イメージをダウンロードする前に、まず、サポート資格証明を使用してOracle Container Registryにログインし、デプロイするコンテナごとにライセンス契約に同意する必要があります。
ライセンス契約に同意すると、Oracle Container Registryから直接イメージをプルできるようになります。必ず、最新のバンドル・パッチが適用されたイメージをプルしてください。
- オンデマンドでOracle Container Registryからコンテナ・イメージを取得します。この方法を使用する場合は、各項に示されたコンテナ・レジストリの使用手順に従います。
- コンテナ・イメージをOracle Container Registryから手動でプルし、各ワーカー・ノードに手動でステージングします。「コンテナ・レジストリからのイメージのダウンロード」を参照してください。
- コンテナ・イメージをOracle Container Registryから手動でプルしてから、独自のコンテナ・レジストリにアップロードします。「コンテナ・レジストリからのイメージのダウンロード」および「OCIコンテナ・レジストリの使用」を参照してください。
親トピック: エンタープライズ・デプロイメント用のソフトウェアの調達
コンテナ・レジストリからのイメージのダウンロード
コンテナ・レジストリを使用する場合は、オンデマンドまたは事前にレジストリからイメージをプルできます。イメージを事前にプルするとデプロイメントが高速になりますが、そのワーカー・ノードでコンテナを実行しているかどうかに関係なく、すべてのワーカー・ノードで使用できるイメージがあることを意味します。
ノート:
Oracleコンテナ・レジストリの最新イメージは、レジストリにログインした後にのみ使用でき、_cpu
の接尾辞付きで使用できます。たとえば、最新のoamイメージはoam_cpu
で使用できます。
コンテナ・レジストリからイメージをダウンロードするには、各ワーカー・ノードでコマンドを実行する必要があります。
CRI-Oへのイメージのプル
イメージをCRI-Oにダウンロードするには、次の2つのオプションがあります:
オプション1: podman
の使用
ノート:
rootユーザーとしてpodmanを実行する必要があります。crictl
の使用crictl
コマンドを使用してイメージをロードします:crictl pull --creds username:password repository/image:version
ここで、username
およびpassword
は、レジストリへのアクセスに使用するユーザーの名前および関連付けられたパスワードです。
crictl pull --creds myuser:password container-registry.oracle.com/middleware/oam_cpu:12.2.1.4-jdk8-ol8-240415
親トピック: コンテナ・レジストリからのイメージのダウンロード
Oracle Advanced Authentication
コンテナ・レジストリ経由ではなくOracleサポートからOAAイメージをダウンロードした場合は、zipファイルがダウンロードされます。
zipファイルのイメージ・コンテナをロードするには、最初に次のコマンドを使用してファイルを解凍します:
unzip oaa-install-<REL>.zip
/oaa-install/oaa-<REL>.tar
というイメージ・アーカイブ・ファイルが取得されます。
このファイルは、「コンテナ・イメージのステージング」のコマンドを使用してステージングできます。
親トピック: コンテナ・レジストリからのイメージのダウンロード
コンテナ・イメージのステージング
docker
またはpodman
コマンドにアクセスできる任意のホストで実行できます。ホストがKubernetesクラスタの一部である必要はありません。
ローカルにステージングしたイメージを使用している場合は、各ワーカー・ノードがデプロイメント内のすべてのコンテナ・イメージにアクセスできる必要があります。Kubernetesによって、どのワーカー・ノードでコンテナを起動するかが決定されます。そのため、すべてのホストでイメージが使用可能になっている必要があります。ローカルにステージングしたイメージを使用している場合は、これらの手順を使用して、各ワーカー・ノードにイメージを手動でロードできます。ただし、コンテナ・レジストリを使用しているが、事前にイメージをワーカー・ノードにロードしようとする場合は、コンテナ・レジストリから各ワーカー・ノードにイメージを手動でプルする必要があります。
Dockerでのイメージのステージング
Dockerをコンテナ・リポジトリとして使用する場合は、Oracle Identity and Access Managerコンテナ・イメージを各Kubernetesワーカー・ノード上のDockerリポジトリにステージングする必要があります。
コンテナ・イメージをコンテナ・レジストリに格納する場合は、「OCIコンテナ・レジストリの使用」を参照してください。
コンテナ・イメージをステージングするには:
親トピック: コンテナ・イメージのステージング
CRI-Oでのイメージのステージング
CRI-Oをコンテナ・リポジトリすなわちOracle Cloud Native Environmentデプロイメントの標準リポジトリとして使用する場合は、Oracle Identity and Access Managerコンテナ・イメージを各Kubernetesワーカー・ノード上のCRI-Oリポジトリにステージングする必要があります。
ノート:
- この項のコマンドは、
podman
コマンドに依存します。デフォルトでは、このコマンドはOracle Cloud Native Environmentで使用できます。ただし、CRI-O (リリース1.20+)を使用するOKE環境にコマンドを手動でインストールする必要があります。podman
コマンドをrootユーザーとして実行してください。 - Oracle Advanced Authenticationで使用されるファイルなどの複数イメージ・アーカイブ・ファイルを使用している場合は、最新リリースのpodmanを使用する必要があります。OCNE 1.3で提供されるリリースでは、複数イメージ・アーカイブはサポートされていません。
コンテナ・イメージをステージングするには:
親トピック: コンテナ・イメージのステージング
GitHubへのログイン
次の例では、パブリック・リポジトリであるgithub.com
からイメージおよびスクリプトをプルする必要があります。GitHubからイメージを正常にプルするには、リポジトリにログインする必要があります。
GitHubには、次のいずれかの方法でログインできます:
- 各ホストで手動ログインを実行することで、リポジトリへのアクセスが必要になります。
- Kubernetesシークレットを作成して、Kubernetesクラスタへのアクセス権を付与します。
GitHubにアクセスするためのシークレットの作成
GitHubからコンテナをデプロイする必要がある場合は、コンテナ・レジストリで認証するトークンを作成する必要があります。
GitHubトークンの作成
この項では、GitHubアカウントがあることを前提としています。GitHubアカウントがない場合は、続行する前に作成する必要があります
GitHubトークンを作成するには:
生成されたトークンを書き留めます。そうしないと、二度と見つけることができなくなります。
親トピック: GitHubにアクセスするためのシークレットの作成
Kubernetesシークレットの作成
GitHubトークンを作成した後、GitHubからイメージをプルできるKubernetesシークレットを作成できるようになります。次のコマンドは、デフォルト・ネームスペースに'github'というKubernetesシークレットを作成します:
kubectl create secret docker-registry github --docker-server=ghcr.io --docker-username=mygituser --docker-password="mytoken"
親トピック: GitHubにアクセスするためのシークレットの作成
GitHubへの手動ログイン
各ワーカー・ホストでGithHubに手動でログインするには、次のコマンドを使用します。
docker login ghcr.io
プロンプトが表示されたら、ユーザー名と、事前に作成したトークンを指定します。「GitHubトークンの作成」を参照してください。
sudo podman login ghcr.io
プロンプトが表示されたら、ユーザー名と、事前に作成したトークンを指定します。
親トピック: GitHubへのログイン
WebLogic Operator for Kubernetesのステージング
WebLogic Operator for Kubernetesを使用して、Oracle Access ManagerまたはOracle Identity Governanceをデプロイします。WebLogic Operatorには、WebLogic Operatorのコンテナ・イメージとWebLogic Operatorのデプロイメント・スクリプトの2つの部分があります。
WebLogic Operator for Kubernetesは、oracle.github.io
から入手できます。GitHubにサインインして、コンテナ・イメージをダウンロードします。
親トピック: エンタープライズ・デプロイメント用のソフトウェアの調達
DockerでのOracle WebLogic Kubernetesイメージのステージング
docker pull ghcr.io/oracle/weblogic-kubernetes-operator:<VERSION>
docker tag ghcr.io/oracle/weblogic-kubernetes-operator:<VERSION> weblogic-kubernetes-operator:<VERSION>
docker pull ghcr.io/oracle/weblogic-kubernetes-operator:3.3.0
docker tag ghcr.io/oracle/weblogic-kubernetes-operator:<VERSION> weblogic-kubernetes-operator:3.3.0
Operatorをすべてのマスター・ノードとワーカー・ノードにステージングするか、クラスタからアクセス可能なレジストリに配置する必要があります。
CRI-OでのOracle WebLogic Kubernetesイメージのステージング
sudo podman pull ghcr.io/oracle/weblogic-kubernetes-operator:<VERSION>
sudo podman tag ghcr.io/oracle/weblogic-kubernetes-operator:<VERSION> weblogic-kubernetes-operator:<VERSION>
たとえば: CRI-Oでイメージをステージングするには、次のコマンドを使用します:
sudo podman pull ghcr.io/oracle/weblogic-kubernetes-operator:3.3.0
sudo podman tag ghcr.io/oracle/weblogic-kubernetes-operator:3.3.0 weblogic-kubernetes-operator:3.3.0
ノート:
podman
コマンドをrootユーザーとして使用してください。
Operatorをすべてのマスター・ノードとワーカー・ノードにステージングするか、クラスタからアクセス可能なレジストリに配置する必要があります。
コード・リポジトリのステージング
Oracleには、Oracle Identity and Access ManagementをKubernetesにデプロイするためのサンプル・コード・リポジトリが用意されています。このガイドで説明する手順では、多くの場合、サンプル・コード・リポジトリを使用します。構成ホストの一時作業ディレクトリにサンプル・コード・リポジトリをダウンロードします。
構成ホストは、helm
およびkubectl
コマンドを実行できるクラスタ内の任意のホストです。たとえば、OCIインストールでは、このホストを要塞ホストにできます。Oracle Cloud Native Environmentインストールの場合、オペレータ・ノードまたはコントロール・プレーン・ホストのいずれかになります。または、その目的のために特定のホストを定義している可能性があります。
サンプル・コードはGitHubから入手できます。アクセス権がない場合は、アカウントを作成してログインすることが必要になる場合があります。
スクリプトをダウンロードするには、GitHubにログインし、次のステップを実行します:
これらのコマンドは、すべてのサンプル・ファイルが格納されるfmw-kubernetes
というディレクトリを作成します。この場所からファイルを直接使用することも、必要なファイルを別の一時作業ディレクトリにコピーすることもできます。すべてを別々に保持するために、このガイドで説明する手順では、ファイルを製品の作業ディレクトリにコピーすることをお薦めします。例: /workdir/OAM
。ただし、これはオプションです。
ノート:
このコード・リポジトリには、このガイドの手順に従ってOracle Identity and Access Managementをデプロイするためのサンプル自動化スクリプトも含まれています。親トピック: エンタープライズ・デプロイメント用のソフトウェアの調達
Oracle Identity Governance用のOracle Connectorバンドルのダウンロード
Oracle Identity Governanceを外部システムと統合する場合、適切なコネクタ・バンドルをダウンロードする必要があります。エンタープライズ・デプロイメントでは、LDAPコネクタを使用してOracle Unified Directory (OUD)およびOracle Internet Directory (OID)と統合します。
最新バージョンのOracle ConnectorバンドルをOracle Identity Manager Connectorのダウンロードからダウンロードします。
親トピック: エンタープライズ・デプロイメント用のソフトウェアの調達