この文書は自動機械翻訳技術を使用して翻訳されています。 正確な翻訳を提供するように努めておりますが、翻訳された内容の完全性、正確性、信頼性については一切保証いたしません。 相違がある場合は、元の英語版 英語 が優先され、正式なテキストとなります。

Google Kubernetes EngineクラスターにSUSE Rancher Primeをインストールする

このセクションでは、Google Kubernetes Engineを使用してRancherをインストールする方法を学びます。

すでにGKE Kubernetesクラスターをお持ちの場合は、イングレスのインストールに関するステップにスキップしてください。次に、このページの指示に従ってRancher Helmチャートをインストールします。

前提条件

  • Googleアカウントが必要です。

  • Google Cloudの請求アカウントが必要です。Google Cloud Consoleを使用してCloud Billingアカウントを管理できます。Cloud Consoleに関する詳細情報については、 コンソールの一般ガイドをご覧ください。

  • 使用中のIPアドレスが少なくとも1つ、CPUが少なくとも2つのクラウドクォータが必要です。Rancherサーバーのハードウェア要件に関する詳細は、このセクションを参照してください。

1.Kubernetes Engine APIを有効にする

Kubernetes Engine APIを有効にするための手順は以下の通りです：

  1. Google Cloud Consoleの Kubernetes Engineページにアクセスします。

  2. プロジェクトを作成または選択します。

  3. プロジェクトを開き、そのプロジェクトのKubernetes Engine APIを有効にします。APIと関連サービスが有効になるまで待ちます。これには数分かかる場合があります。

  4. Cloudプロジェクトの請求が有効になっていることを確認してください。プロジェクトの請求を有効にする方法については、 Google Cloudのドキュメントを参照してください。

2.Cloud Shellを開く

Cloud Shellは、Google Cloud上でホストされているリソースを管理するためのシェル環境です。Cloud Shellには、`gcloud`コマンドラインツールとkubectlコマンドラインツールがプリインストールされています。`gcloud`ツールはGoogle Cloudの主要なコマンドラインインターフェースを提供し、`kubectl`はKubernetesクラスターに対してコマンドを実行するための主要なコマンドラインインターフェースを提供します。

以下のセクションでは、Google Cloud Consoleまたはローカルワークステーションからクラウドシェルを起動する方法について説明します。

クラウドシェル

Google Cloud Console,からシェルを起動するには、コンソールの右上隅に移動し、ターミナルボタンをクリックします。ボタンにカーソルを合わせると、*Cloud Shellを有効にする*と表示されます。

ローカルシェル

`gcloud`と`kubectl`をインストールするには、次の手順を実行します：

  1. これらの手順に従ってCloud SDKをインストールします。Cloud SDKには`gcloud`コマンドラインツールが含まれています。手順はOSによって異なります。

  2. Cloud SDKをインストールした後、次のコマンドを実行して`kubectl`コマンドラインツールをインストールします：

     gcloud components install kubectl

    後のステップで、`kubectl`は新しいGKEクラスターを使用するように設定されます。

  3. Helm 3がまだインストールされていない場合は、インストールしてください。

  4. OCI イメージのための Helm の実験的サポート を HELM_EXPERIMENTAL_OCI 変数で有効にします。次の行を`/.bashrc`に追加します（macOSでは`/.bash_profile`、またはシェルが環境変数を保存する場所に追加します）：

     export HELM_EXPERIMENTAL_OCI=1

  5. 次のコマンドを実行して、更新された`.bashrc`ファイルを読み込みます：

     source ~/.bashrc

    macOSを使用している場合は、このコマンドを使用します：

     source ~/.bash_profile

3.gcloud CLIを設定します

次のいずれかの方法を使用して、デフォルトの gcloud 設定をセットアップします：

  • gcloud init を使用する場合、デフォルト設定の手順が案内されます。

  • gcloud configを使用して、プロジェクト ID、ゾーン、およびリージョンを個別に設定します。

  • gcloud initを使用します。

  • gcloud configを使用します。

  1. gcloud initを実行し、指示に従ってください：

      gcloud init

    リモートサーバーで SSH を使用している場合は、コマンドがブラウザを起動しないように --console-only フラグを使用してください：

      gcloud init --console-only

  2. 指示に従って、gcloud があなたの Google Cloud アカウントを使用するための承認を行い、作成した新しいプロジェクトを選択してください。

4.gcloud が正しく構成されていることを確認します。

次のスクリプトを実行します。

gcloud config list

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

[compute]
region = us-west1 # Your chosen region
zone = us-west1-b # Your chosen zone
[core]
account = <Your email>
disable_usage_reporting = True
project = <Your project ID>

Your active configuration is: [default]

5.GKE クラスターを作成します。

次のコマンドは、3 ノードのクラスターを作成します。

cluster-name を新しいクラスターの名前に置き換えてください。

Kubernetesのバージョンを選択する際は、最初に サポートマトリックスを確認して、Rancherのバージョンに対して検証された最高のKubernetesバージョンを見つけてください。

RancherでGKEクラスターを正常に作成するには、GKEがスタンダードモードである必要があります。GKEには、Kubernetesクラスターを作成する際に、オートパイロットモードとスタンダードモードの2つの操作モードがあります。オートパイロットモードのクラスター構成には、kube-systemネームスペースの編集に制限があります。ただし、Rancherはインストール中にkube-systemネームスペースにリソースを作成する必要があります。その結果、Autopilot モードで作成された GKE クラスターに Rancher をインストールすることはできません。GKEオートパイロットモードとスタンダードモードの違いについての詳細は、 GKEオートパイロットとスタンダードの比較を参照してください。

gcloud container clusters create cluster-name --num-nodes=3 --cluster-version=<VERSION>

6.認証情報を取得します。

クラスターを作成した後、クラスターと対話するための認証情報を取得する必要があります：

gcloud container clusters get-credentials cluster-name

このコマンドは、kubectl を作成したクラスターを使用するように構成します。

7.Ingressをインストールする

クラスターには、Rancherがクラスターの外部からアクセスできるようにするためにIngressが必要です。Ingressをインストールするには、パブリックIPアドレスを割り当てる必要があります。十分なクォータがあることを確認してください。そうでないと、IPアドレスの割り当てに失敗します。パブリックIPアドレスの制限は、サブスクリプションごとに地域レベルで適用されます。GCP が提供するマネージドイングレスコントローラーや、Traefik のようなサードパーティのイングレスコントローラーを使用できます。

マネージドイングレスコントローラーがすでに使用されている場合、Traefik のようなサードパーティのイングレスコントローラーをインストールすることは推奨されません。

Ingress-NGINX EOL:コミュニティの`ingress-nginx`コントローラーは2026年3月にサービス終了となります。このページでは、Rancher環境に推奨される移行パスであるTraefikを使用しています。

Traefikには、ネイティブのIngress NGINXプロバイダーが含まれています。これにより、既存のIngressオブジェクトを再記述することなくNGINXから移行でき、Traefikは`nginx.ingress.kubernetes.io`アノテーションを自動的に解釈します。すでに`ingress-nginx`を使用しているクラスターをアップグレードする場合は、詳細についてはこの ガイドに従ってください。

Traefikをインストールするには、 Rancher Prime Application CollectionのTraefikアプリケーションを使用することを強くお勧めします。Rancher Managerと統合するための ドキュメントを確認してください。

8.ロードバランサーIPを取得する

ロードバランサーのアドレスを取得するには、次のコマンドを実行します：

kubectl get service traefik --namespace=traefik

結果は次のようになります：

NAME                       TYPE           CLUSTER-IP     EXTERNAL-IP                                                              PORT(S)
 AGE
traefik  LoadBalancer   10.0.116.18    40.31.180.83   80:31229/TCP,443:31050/TCP 27m

`EXTERNAL-IP`を保存します。

9.DNSを設定します。

Rancherサーバーへの外部トラフィックは、作成したロードバランサーに向ける必要があります。

保存した外部IPを指すDNSを設定します。このDNSはRancherサーバーのURLとして使用されます。

DNSを設定するための有効な方法は多数あります。ヘルプが必要な場合は、 DNS レコードの管理に関する Google Cloud ドキュメントを参照してください。

10.Rancher Helm チャートをインストールします。

次に、このページの指示に従って Rancher Helm チャートをインストールします。Helm の指示は、任意の Kubernetes ディストリビューションに Rancher をインストールする際に同じです。

Rancher をインストールする際には、前のステップで得た DNS 名を Rancher サーバーの URL として使用します。それは Helm オプションとして渡すことができます。例えば、DNS 名が rancher.my.org の場合、オプション --set hostname=rancher.my.org を使用して Helmインストールコマンドを実行できます。

このセットアップの上にRancherをインストールする際には、Rancherのingressリソースで使用するingressコントローラーの名前を設定する必要があります。

--set ingress.ingressClassName=traefik

選択した証明書オプションの Helm インストールコマンドについては、こちらを参照してください。

Rancher v2.7.5では、VPCネイティブクラスター モードを有効にせずにクラスターでデフォルトのGKE ingressを使用する予定の場合、次のフラグを設定する必要があります。

--set service.type=NodePort

これは、セットアップと、`cattle-system/rancher`のデフォルトタイプであるClusterIPとの互換性の問題があるため、必要です。