Google Cloud への Knative serving のインストール

Google Cloud 上の GKE クラスタに Knative serving をインストールする方法について説明します。Knative serving では、Anthos Service Mesh と GKE Enterprise フリートが使用されるようになりました。Knative serving フリートのインストールの新機能と変更点はこちらをご覧ください。

警告: このページの手順を行うと、Knative serving の新規インストールが実行され、以前のフリートではないインストールは不可逆的に上書きされます。以前に Knative serving を有効にしたクラスタでは、以降の手順を実行しないでください。

以前に Knative serving の「無料トライアル」をインストールした場合は、まず GKE Enterprise フリートを使用するように Knative serving をアップグレードする必要があります。

このページは、Google Cloud の GKE クラスタに Knative serving のデフォルト コンポーネントを次の構成でインストールするためのものです。

  • Google Cloud の Knative serving は、デフォルトで一般公開クラスタ用に構成されています。

  • Google Cloud 上の GKE Enterprise クラスタの Cloud Monitoring 指標は、デフォルトで有効になっています。

始める前に

  • Google Cloud の限定公開クラスタに Knative serving をインストールするには、カスタム インストールを実施する必要があります。

  • インストールの前提条件を満たしていることを確認する必要があります。

  • Knative serving がクラスタにインストールされている場合、これらのフリート コンポーネントのインストール手順を行う前に、「GKE アドオン」が存在しないことを確認する必要があります。「アドオン」がインストールされている場合は、GKE Enterprise フリートのアップグレード手順を行う必要があります。

    「GKE アドオン」がインストールされているかどうかを確認します。

    Knative serving のインストールが GKE アドオンであるかどうかを確認するには、次のコマンドを実行します。

    gcloud container clusters describe \
CLUSTER_NAME \
--region CLUSTER_LOCATION \
--project PROJECT_ID --format='get(addonsConfig.cloudRunConfig)'

    次のように置き換えます。

    • CLUSTER_NAME は、使用するクラスタの名前に置き換えます。
    • CLUSTER_LOCATION は、クラスタが配置されているロケーションに置き換えます。
    • PROJECT_ID は、Google Cloud プロジェクトの ID です。

    結果:

    • 「GKE アドオンがインストールされていない」:
      • アドオンがインストールされていない場合、ターミナルにはなにも返されません。
      • アドオンがすでにアンインストールされている場合、disabled=true が返されます。
    • 「GKE アドオンがインストールされている」: アドオンがクラスタにインストールされている場合は、アドオンの構成の詳細が返されます。例: loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL
    例:
    次の例では、Knative serving が GKE アドオンを介して my-addon-cluster クラスタにインストールされ、外部トラフィックを処理するように構成されていることを示します。
    gcloud container clusters describe my-addon-cluster \
--region us-central1-c --project my-gcp-project \
--format='get(addonsConfig.cloudRunConfig)'

    レスポンス: 

    loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL

Knative serving のインストール

Knative serving のデフォルト コンポーネントをインストールするには:

  1. フリートで Knative serving を有効にします。

    gcloud container fleet cloudrun enable --project=PROJECT_ID

    PROJECT_ID は、Google Cloud プロジェクトの ID に置き換えます。

    詳細とその他のオプションについては、gcloud container fleet cloudrun enable のリファレンスをご覧ください。

  2. 省略可: Knative serving 機能コンポーネントが有効になっていることを確認します。

    コンソール

    Google Cloud コンソールで、Knative serving コンポーネントが有効になっているかどうかを確認します。

    GKE Enterprise の [機能] に移動

    コマンドライン

    appdevexperience の状態が ACTIVE であるかどうかを確認します。

    gcloud container fleet features list  --project=PROJECT_ID

    PROJECT_ID は、Google Cloud プロジェクトの ID に置き換えます。

    詳細と他のオプションについては、gcloud container fleet features list をご覧ください。

    結果:

    NAME               STATE
appdevexperience   ACTIVE

  3. Knative serving をインストールする GKE Enterprise クラスタごとに、対応するコマンドを実行します。

    gcloud container fleet cloudrun apply --gke-cluster=CLUSTER_LOCATION/CLUSTER_NAME

    次のように置き換えます。

    • CLUSTER_LOCATION: クラスタが配置されているリージョンまたはゾーン。
    • CLUSTER_NAME: クラスタの ID またはクラスタの完全修飾識別子。

    詳細とその他のオプションについては、gcloud container fleet cloudrun apply のリファレンスをご覧ください。

  4. クラスタで Knative serving が有効になっていることを確認します。
    1. Google Cloud コンソールを開きます。

      GKE Enterprise クラスタに移動

    2. クラスタの名前をクリックして、詳細ペインを開きます。

    3. 次のコマンドを実行して、Knative serving のバージョンの詳細が表示されるかどうかを確認します。kubectl get namespace knative-serving -o 'go-template={{index .metadata.labels "serving.knative.dev/release"}}'
    4. knative-serving と appdevexperience の名前空間で、Knative serving 固有のデプロイがすべて実行中であることを確認します。

次のステップ

Knative serving のインストールを設定する。