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

Google Cloud 上の GKE クラスタに Knative serving をインストールする方法について説明します。Knative serving では、Cloud 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 コンポーネントが有効になっているかどうかを確認します。

    機能マネージャーに移動

    コマンドライン

    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 クラスタに移動

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

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

次のステップ

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