1. KubernetesクラスタへのOracle SOA Suiteの自動デプロイ
  2. 前提条件のインストール

前提条件のインストール

スタックを実行するために必要なKubernetesアーティファクトは、KubernetesにHelmチャートとしてデプロイされるため、kubectlおよびHelmをインストールする必要があります。さらに、kubectlに必要なOracle Cloud Infrastructureコマンドライン・インタフェース(CLI)が必要であり、他のタスクに役立ちます。

このステップでは、次のコンポーネントをインストールします。
  1. OCIコマンドライン・インタフェース。
  2. まだ存在しない場合、kubectlバージョン1.18以上。
  3. Helm 3.x。

Oracle Cloud Infrastructureコマンドライン・インタフェースのインストール

まず、Oracle Cloud Infrastructureコマンドライン・インタフェース(CLI)をインストールします。

  1. LinuxまたはMac OS XにOCI CLIをインストールするには、次のコマンドを実行します:
    bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)"

    [Enter]を押して、すべてのオプションのデフォルトを使用します。

  2. シェルを再起動します。
    exec -l $SHELL
  3. テナンシおよびユーザーOCIDsを収集します:
    1. Oracle CloudコンソールからテナンシOCIDを取得するには、「ユーザー」アイコン(右上隅)をクリックしてから「テナンシ」をクリックします。テナンシのOCID (「テナンシ」フィールド)をコピーします。
    2. 「ユーザー」、「ユーザー設定」の順にクリックして、コンソールからユーザーOCIDを取得します。次に、ユーザーのOCIDをコピーします。
  4. OCI CLIを構成します。 
    oci setup config
    次を要求されます:
    • 構成の場所: Enterキーを押します。
    • user_ocid: ユーザーOCIDを入力します。
    • tenancy_ocid: テナンシOCIDを入力します。
    • region: 提供されたリストからリージョンを入力します。
    • RSAキー・ペアの生成: [Enter]を押して「はい」(デフォルト)を押します。
    • キーのディレクトリ:デフォルトは[Enter]を押します。
    • キーの名前: デフォルトの[Enter]を押します。
    • Passphrase:パスフレーズなしの場合は、Enterキーを押します。
    次のような出力が表示されます。 
    Private key written to: /home/oracle/.oci/oci_api_key.pem
Fingerprint: 21:d4:f1:a0:55:a5:c2:ce:...
Config written to ~/.oci/config
  5. CLIを使用するには、生成された公開キーをユーザー・アカウントにアップロードする必要があります。次のように入力して、主要なコンテンツを取得します: 
    cat ~/.oci/oci_api_key_public.pem

    オプションで、任意のエディタでファイルを開き、完全な印刷出力をクリップボードにコピーできます。

  6. OCI Webコンソールで、前のステップで生成されたキーを追加します:
    1. 「ユーザー」→「ユーザー設定」をクリックします。
    2. 「APIキー」をクリックします。
    3. 公開キーの追加をクリックします。
    4. 「公開キーの貼付け」をクリックします。
    5. 上でコピーしたキーを貼り付けます。
    6. 「追加」をクリックします。
    7. 生成されたフィンガープリントが構成のフィンガープリント出力と一致することを確認します。
  7. 次のように入力してCLIをテストします: 
    oci os ns get
    このコマンドは、テナンシのネームスペース(通常はテナンシの名前またはランダム化された文字列)を出力する必要があります。次に例を示します:
    {
    "data": "your-tenancy-namespace"
}

kubectlのインストール

次に、Kubernetesコマンドライン・ツールkubectlをインストールします。

ノート:

Mac OS XまたはWindowsでDocker Desktopを使用している場合は、kubectlがすでにインストールされており、このステップをスキップできます。

次に、kubectlをインストールする手順の概要を示します。O/Sに固有の手順の詳細は、Kubernetesオンライン・ドキュメントの「インストール・ツール」を参照してください(開始する前にのトピックを参照)。

  1. kubectlをインストールするには、次のコマンドを実行します。
    PLATFORM=$(uname)
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/${PLATFORM,,}/amd64/kubectl"
chmod +x ./kubectl
sudo mv ./kubectl /usr/local/bin/kubectl
    Windowsでは、次を使用します。 
    curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.20.0/bin/windows/amd64/kubectl.exe
  2. バイナリをPATHに追加します。
  3. 次のように入力して、1.18以上のkubectlバージョンを使用していることを確認します:
    kubectl version --client

Helmをインストールします

次に、Helm CLIをインストールします。

次に、Helmのインストール手順の概要を示します。O/Sに固有の手順の詳細は、「開始する前に」のトピックにリストされている「Helmのインストール」を参照してください。

Mac OS XおよびLinuxにhelmをインストールするには、次のように入力します。 
curl https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3 | bash

Terraformのインストール

最後に、まだインストールされていない場合は、Terraformをインストールする必要があります。

ノート:

このトピックで説明するインストールドキュメントへのリンクについては、「始める前に」のトピックを参照してください。
If you are on a Linux-based machine or Mac OS X, we recommend you install Terraform by using tfswitch, as described in Install in tfswitch documentation, as it allows easy switching between Terraform versions. If you installed tfswitch, select a version with: 
tfswitch

このプレイブックは、Terraformバージョン0.14.11でテストされました

それ以外の場合、Terraformを設定するためのガイダンスが必要な場合は、Terraformのインストールドキュメントにアクセスし、環境に対応するパスを選択してください。