2.7. システムデータベースに Oracle を使用する 3scale の operator によるインストール

手順

1. 新しいデータベースを作成します。

2. 次の設定を適用します。

   ALTER SYSTEM SET max_string_size=extended SCOPE=SPFILE;

   Copy to Clipboard Toggle word wrap

3. 3scale を使用して Oracle データベースをインストールする前に、通常の非システムユーザーを作成します。

   1. 通常の Oracle Database の非システムユーザーのパスワードは一意で、system パスワードとは一致しないようにする必要があります。

   2. Oracle データベースの初期化スクリプトは、次の SQL コマンドを実行します。

      ALTER USER {DB_USER} IDENTIFIED BY {DB_PASSWORD}

      Copy to Clipboard Toggle word wrap
      • 3scale のインストールを開始する前に、この SQL コマンドが正しく実行することを確認してください。
      • {DB_USER} および {DB_PASSWORD} は、通常の非システムユーザーのユーザー名およびパスワードです。
      • パラメーター PASSWORD_REUSE_TIME および PASSWORD_REUSE_MAX が同じパスワードの再利用を制限するように設定されている場合、データベース設定によっては、このコマンドが正常に完了しない場合があります。

      • Oracle Database の system ユーザーは、システム権限でコマンドを実行します。

        • 一部は、こちらの GitHub リポジトリー に詳細があります。
        • テーブルがデータベースで初期化されると、Oracle Database のイニシャライザー で最新のものを実行できます。これらのリンクにリストされていない他のコマンドが存在する可能性があります。
      • スキーマ移行がある場合に、アップグレードするには system ユーザーが必要であるため、直前のリンクに含まれていない他のコマンドを実行することもできます。

手順

1. GitHub リポジトリーから 3scale OpenShift テンプレートをダウンロードし、アーカイブを展開します。

   tar -xzf 3scale-amp-openshift-templates-3scale-2.12.0-GA.tar.gz

   Copy to Clipboard Toggle word wrap

2. Instant Client Downloads ページから、以下をダウンロードします。

   • クライアント:basic-lite または basic のいずれかを使用できます。
   • ODBC ドライバー

   • Oracle Database 19c の SDK

     • 3scale の場合は、Instant Client Downloads for Linux x86-64(64-bit) を使用します。
     • ppc64le および 3scale の場合は、Power Little Endian (64 ビット) 上の Linux の Oracle Instant Client Downloads for Linux を使用します。

3. 以下の Oracle ソフトウェアコンポーネントについては、Red Hat 3scale API Management のサポート対象設定 を確認してください。

   • Oracle Instant Client パッケージ:Basic または Basic Light
   • Oracle Instant Client パッケージ:SDK

   • Oracle Instant Client パッケージ:ODBC

     Expand

     表2.3 3scale 向けの Oracle 19c パッケージの例

     Oracle 19c パッケージ名	圧縮ファイル名
     Basic	instantclient-basic-linux.x64-19.8.0.0.0dbru.zip
     Basic Light	instantclient-basiclite-linux.x64-19.8.0.0.0dbru.zip
     SDK	instantclient-sdk-linux.x64-19.8.0.0.0dbru.zip
     ODBC	instantclient-odbc-linux.x64-19.8.0.0.0dbru.zip

     Show more
     Expand

     表2.4 ppc64le および 3scale 用 Oracle 19c パッケージの例

     Oracle 19c パッケージ名	圧縮ファイル名
     Basic	instantclient-basic-linux.leppc64.c64-19.3.0.0.0dbru.zip
     Basic Light	instantclient-basiclite-linux.leppc64.c64-19.3.0.0.0dbru.zip
     SDK	instantclient-sdk-linux.leppc64.c64-19.3.0.0.0dbru.zip
     ODBC	instantclient-odbc-linux.leppc64.c64-19.3.0.0.0dbru.zip

     Show more
   注記

   ローカルにダウンロードされて保存されたクライアントパッケージバージョンが、3scale が想定するバージョンと一致しない場合には、以下の手順で 3scale は適切なバージョンを自動的にダウンロードして使用します。

4. Oracle Database の Instant Client パッケージファイルを 3scale-amp-openshift-templates-3scale-2.12-GA/amp/system-oracle/oracle-client-files ディレクトリーに配置します。

5. レジストリーサービスアカウントの作成 で作成したクレデンシャルを使用して、registry.redhat.io アカウントにログインします。

   $ docker login registry.redhat.io

   Copy to Clipboard Toggle word wrap

6. システムの Oracle ベースのカスタムイメージをビルドします。以下の例に示すように、固定のイメージタグを設定する必要があります。

   $ docker build . --tag myregistry.example.com/system-oracle:2.12.0-1

   Copy to Clipboard Toggle word wrap

7. システムの Oracle ベースのイメージを、OCP クラスターからアクセス可能なコンテナーレジストリーにプッシュします。このコンテナーレジストリーに、この後 3scale ソリューションがインストールされます。

   $ docker push myregistry.example.com/system-oracle:2.12.0-1

   Copy to Clipboard Toggle word wrap

手順

1. 該当するフィールドを使用して system-database シークレットを作成し、Oracle Database URL の接続文字列および Oracle Database のシステムパスワードを設定します。Oracle Database については、外部データベースモードでのインストール を参照してください。

2. APIManager カスタムリソースを作成して、3scale ソリューションをインストールします。operator を使用した 3scale のデプロイ に記載の手順に従います。

   • APIManager カスタムリソースでは、.spec.system.image フィールドを前のステップでビルドしたシステムの Oracle ベースのイメージに設定する必要があります。

     apiVersion: apps.3scale.net/v1alpha1
     kind: APIManager
     metadata:
       name: example-apimanager
     spec:
       imagePullSecrets:
       - name: threescale-registry-auth
       - name: custom-registry-auth
       system:
         image: "myregistry.example.com/system-oracle:2.12.0-1"
       externalComponents:
         system:
           database: true

     Copy to Clipboard Toggle word wrap