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

手順

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

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

   ALTER SYSTEM SET max_string_size=extended SCOPE=SPFILE;

3. データベースユーザーを設定します。

   3scale で Oracle Database インテグレーションをセットアップするには、Oracle SYSTEM ユーザーパスワードを指定する場合と指定しない場合の 2 つのオプションがあります。

   3scale は、通常のユーザーを作成し、それに必要な権限を付与する初期セットアップでのみ SYSTEM ユーザーを使用します。次の SQL コマンドは、適切な権限を持つ通常のユーザーをセットアップします。({DB_USER} と {DB_PASSWORD} は、実際の値に置き換える必要があるプレースホルダーです)。

   CREATE USER {DB_USER} IDENTIFIED BY {DB_PASSWORD};
   GRANT unlimited tablespace TO {DB_USER};
   GRANT create session TO {DB_USER};
   GRANT create table TO {DB_USER};
   GRANT create view TO {DB_USER};
   GRANT create sequence TO {DB_USER};
   GRANT create trigger TO {DB_USER};
   GRANT create procedure TO {DB_USER};

   1. SYSTEM ユーザーの使用:

      • system-database シークレットの ORACLE_SYSTEM_PASSWORD フィールドに SYSTEM ユーザーのパスワードを指定します。
      • インストール前に通常のユーザーが存在する必要はありません。これは 3scale 初期化スクリプトによって作成されます。
      • system-database シークレットの URL フィールドの接続文字列 (例: oracle-enhanced://{DB_USER}:{DB_PASSWORD}@{DB_HOST}:{DB_PORT}/{DB_NAME}) に、通常のユーザー用の必要なユーザー名とパスワードを入力します。
      • 通常の Oracle Database 非システムユーザーのパスワードは一意である必要があり、SYSTEM ユーザーのパスワードとは一致しないようにする必要があります。

      • 指定されたユーザー名を持つユーザーがすでに存在する場合、3scale 初期化スクリプトは次のコマンドを使用して、パスワードの更新を試みます。

        ALTER USER {DB_USER} IDENTIFIED BY {DB_PASSWORD}

        パラメーター PASSWORD_REUSE_TIME および PASSWORD_REUSE_MAX が同じパスワードの再利用を制限するように設定されている場合、データベース設定によっては、このコマンドが正常に完了しない場合があります。

   2. 通常のデータベースユーザーの手動セットアップ:

      • system-database シークレットに ORACLE_SYSTEM_PASSWORD を指定する必要はありません。
      • system-database シークレットの URL フィールドの接続文字列で指定された通常のデータベースユーザー (SYSTEM 以外) は、3scale のインストール前に存在している必要があります。
      • インストールに使用する通常のユーザーは、上記のすべての権限を持っている必要があります。

手順

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

   tar -xzf 3scale-2.13.0-GA.tar.gz

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 ソフトウェアコンポーネントのバージョンについては、表を確認してください。

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

   • Oracle Instant Client パッケージ: ODBC

     表2.4 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

     表2.5 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

   注記

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

4. Oracle Database Instant Client Package ファイルを system-oracle-3scale-2.13.0-GA/oracle-client-files ディレクトリーに配置します。

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

   $ docker login registry.redhat.io

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

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

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

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

手順

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

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

   • APIManager CR は、以前にビルドしたシステムの Oracle ベースのイメージに設定された .spec.system.image フィールドを指定する必要があります。

     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.13.0-1"
       externalComponents:
         system:
           database: true