機械翻訳について
  1. クイック・インストレーションforリリース1.8
  2. クイック・インストール

4 クイック・インストール

Kubernetesクラスタを含むベア・メタル・ホストまたは仮想マシンにOracle Cloud Native Environmentをインストールします。

これは、ベア・メタル・ホストまたは仮想マシンにOracle Cloud Native Environmentの基本的なデプロイメントを設定するための最速のメソッドです。 このメソッドは、ノードを設定し、Oracle Cloud Native Environmentプラットフォームをインストールして、Kubernetesクラスタをインストールします。

セキュリティに関する考慮事項: このインストール例を使用する場合は、次のセキュリティ設定を考慮してください:

  • プライベートCA証明書は、Kubernetesノード間のネットワーク通信を保護するために使用されます。

  • SELinuxは、各KubernetesノードのホストOSでpermissiveモードに設定されます。

  • Kubernetes externalIPsサービスはデプロイされません。

より複雑なデプロイメントを実行し、これらのセキュリティ設定を変更するには、「構成ファイルを使用したクイック・インストール」に示すように構成ファイルを使用します。

必要なノード: 少なくとも3つのノード。

  • オペレータ・ノード: オペレータ・ノードとして使用する1つのノード。これは、Platform CLI (olcnectl)を使用してインストールを実行したり、Platform API Serverをホストしたりするために使用されます。

  • Kubernetesコントロール・プレーン: Kubernetesコントロール・プレーン・ノードとして使用する1つのノード。 ロード・バランサなしで複数のコントロール・プレーン・ノードを使用することはできません。

  • Kubernetesワーカー: Kubernetesワーカー・ノードとして使用する1つ以上のノード。

始める前に: 前提条件の設定を完了します。 「事前設定」を参照してください。

ロード・バランサなしでクイック・インストールを実行するには:

  1. オペレータ・ノードで、olcnectl provisionコマンドを使用してインストールを開始します。 必須構文は次のとおりです: 

    olcnectl provision 
--api-server host 
--control-plane-nodes hosts 
--master-nodes hosts (Deprecated)
--worker-nodes hosts
--environment-name name 
--name name

    --api-serverオプションを使用して、プラットフォームAPIサーバーを設定するノードのFQDNを設定します。

    --control-plane-nodesオプションを使用して、プラットフォーム・エージェントで設定され、Kubernetesコントロール・プレーン・ノードのロールが割り当てられるノードのFQDNを設定します。 これはカンマ区切りリストです。

    --worker-nodesオプションを使用して、プラットフォーム・エージェントで設定され、Kubernetesワーカー・ノードのロールが割り当てられるノードのFQDNを設定します。 これはカンマ区切りリストです。

    --environment-nameオプションを使用して、環境を識別するための名前を設定します。

    --nameオプションを使用して、Kubernetesモジュールを識別するための名前を設定します。

    SSHログイン資格証明、プロキシ・サーバー情報、--yesオプションを使用してプロンプトを自動的に受け入れるオプションなど、他のいくつかのコマンド・オプションが必要になる場合があります。 olcnectl provisionコマンドの構文オプションの詳細は、「プラットフォーム・コマンドライン・インタフェース」を参照してください。

    たとえば:

    olcnectl provision \
--api-server operator.example.com \
--control-plane-nodes control1.example.com \
--worker-nodes worker1.example.com,worker2.example.com \
--environment-name myenvironment \
--name mycluster

  2. 各ノードで実行するステップのリストが表示され、続行するためのプロンプトが表示されます。 たとえば、コントロール・プレーン・ノードでは、変更は次のようになります: 

    ? Apply control-plane configuration on control1.example.com:
* Install oracle-olcne-release
...
* Install and enable olcne-agent

Proceed? yes/no(default) yes

    yesと入力して続行します。 ノードが設定されます。

    各ノードの変更に関する情報が表示されます。 各ノードの設定ステップを確認する必要があります。

    ヒント:

    各ノードでの変更の受け入れを回避するには、olcnectl provisionコマンドで--yesコマンド・オプションを使用します。

  3. ノードはOracle Cloud Native Environmentプラットフォームで設定され、KubernetesモジュールがインストールされてKubernetesクラスタが設定されます。 次の構文を使用して環境に関する情報を表示できます: 

    olcnectl module instances 
--api-server host_name:8091 
--environment-name name

    ヒント:

    将来のolcnectlコマンドで--api-serverオプションを使用しないようにするには、--update-configオプションを追加します。

    たとえば:

    olcnectl module instances \
--api-server operator.example.com:8091 \
--environment-name myenvironment \
--update-config

    出力は次のようになります:

    INFO[...] Global flag configuration for myenvironment has been written to the 
local Platform config and you don't need to specify them for any future calls 
INSTANCE                   MODULE      STATE    
control1.example.com:8090  node        installed
...
mycluster                  kubernetes  installed

    デプロイメントの詳細を表示するには、olcnectl module reportコマンドを使用します。 たとえば: 

    olcnectl module report \
--environment-name myenvironment \
--name mycluster \
--children

  4. コントロール・プレーン・ノードでKubernetes CLI (kubectl)を設定します。 kubectlコマンドは、クラスタ内の各コントロール・プレーン・ノードにインストールされます。 これを使用してクラスタにアクセスするには、Kubernetes構成ファイルを使用して構成する必要があります。

    コントロール・プレーン・ノードにログインし、次のコマンドをコピーしてユーザーのホーム・ディレクトリのターミナルに貼り付けます:

    mkdir -p $HOME/.kube
sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
sudo chown $(id -u):$(id -g) $HOME/.kube/config
export KUBECONFIG=$HOME/.kube/config
echo 'export KUBECONFIG=$HOME/.kube/config' >> $HOME/.bashrc

    次のようなkubectlコマンドを使用して、kubectlコマンドを使用できることを確認します: 

    kubectl get deployments --all-namespaces

    出力は次のようになります:

    NAMESPACE                      NAME                            READY   UP-TO-DATE   AVAILABLE   AGE
externalip-validation-system   externalip-validation-webhook   1/1     1            1           29m
kube-system                    coredns                         2/2     2            2           30m
kubernetes-dashboard           kubernetes-dashboard            1/1     1            1           29m
ocne-modules                   ocne-module-operator            1/1     1            1           29m

    ノート:

    デプロイメント後、オペレータ・ノードのローカル・ディレクトリにKubernetes構成ファイルが作成されます。 このファイルにはkubeconfig.environment_name.cluster_nameという名前が付けられ、Kubernetesクラスタに関する情報が含まれます。 このファイルは便宜上作成され、コントロール・プレーン・ノードでkubectlを設定する必要はありません。

    複数のクラスタがある場合は、このファイルを使用して、より大きなKubernetes構成ファイルに追加できます。 複数のクラスタへのアクセスの構成の詳細は、アップストリーム「Kubernetesドキュメント」を参照してください。

ヒント:

Kubernetesクラスタをスケーリングするノードの追加および削除

Kubernetesクラスタのノードを変更するには、更新されたコントロール・プレーンおよびワーカー・ノード・リストを使用して、olcnectl provisionコマンドを再度実行: 新しいノード・リストを省略したノードはクラスタから削除され、指定した新しいノードはクラスタに追加されます。

ノードを追加する場合、新しい証明書が自動的に生成され、新しいノードにインストールされ、Oracle Cloud Native Environmentソフトウェアがインストールされ、ノードがKubernetesクラスタに追加されます。 ただし、外部ロード・バランサを使用している場合は、必要な前提条件(「事前設定」を参照)ですべての新しいノードが設定されていること、および新しいコントロール・プレーン・ノードがロード・バランサに追加されていることを確認する必要があります。

関連項目