この古いバージョンの AI Platform Pipelines は非推奨になりました。2024 年 7 月 31 日が過ぎると Google Cloud で使用できなくなります。従来の AI Platform Pipelines のすべての機能と新機能は、Vertex AI プラットフォームで使用可能です。リソースを Vertex AI Pipelines に移行することで、Kubeflow Pipelines（KFP）のマネージドオーケストレーションエンジンや、多くの追加機能を利用できます。

Google Kubernetes Engine（GKE）にデプロイされた KFP クラスタは、2024 年 7 月 31 日以降も存続します。これらのクラスタには、GKE インターフェースを介してアクセスできます。新しい KFP クラスタは Cloud Marketplace から GKE にデプロイできます。

AI Platform Pipelines のトラブルシューティング

次のヒントを参考にして、AI Platform Pipelines クラスタの問題を解決してください。

パイプライン実行が失敗した理由を理解する

パイプライン実行の各ステップには、ステップのアクティビティを記述するログがあります。これらのログを読み取り、分析して、実行が失敗した理由を把握します。パイプライン実行のログを確認するには、次の手順を行います。

Google Cloud コンソールで AI Platform Pipelines を開きます。

AI Platform Pipelines に移動
Kubeflow Pipelines クラスタの [パイプラインダッシュボードを開く] をクリックします。Kubeflow Pipelines ユーザーインターフェースが新しいタブで開きます。
左側のナビゲーションパネルで、[テスト] をクリックします。パイプラインテストのリストが表示されます。
[All runs] をクリックします。パイプライン実行のリストが表示されます。
トラブルシューティングするパイプライン実行の名前をクリックします。パイプラインのステップが表示されたグラフが開きます。
緑色のチェックマークが付いているパイプラインステップは正常に完了しています。赤色の感嘆符が付いているステップは失敗しています。

トラブルシューティングするパイプラインステップをクリックします。ステップのアーティファクト、入力、出力、ボリューム、マニフェスト、ログを含むセクションが表示されます。
各タブを確認して、入力と出力、作成されたアーティファクト、ログに記録されたアクティビティを確認します。エラーの原因を特定するには、複数のステップにわたって調査が必要になる場合があります。

Kubeflow Pipelines ダッシュボードへのアクセスが禁止されている

AI Platform Pipelines クラスタの Kubeflow Pipelines ダッシュボードへのアクセス中に「禁止」メッセージを受け取った場合は、クラスタにアクセスするための十分な権限がありません。この問題は、他のユーザーが Google Kubernetes Engine クラスタを作成して、AI Platform Pipelines をデプロイしたときに発生する可能性があります。

この問題を解決するには、次の手順でアカウントに AI Platform Pipelines へのアクセスを許可するよう Google Cloud 管理者に依頼します。

次の手順を使用して、ユーザーアカウントに AI Platform Pipelines クラスタへのアクセス権を付与します。

Google Cloud コンソールで AI Platform Pipelines を開きます。

AI Platform Pipelines に移動
AI Platform Pipelines クラスタを探します。以降のステップで使用できるように [クラスタ]と [ゾーン] の値をメモします。
Cloud Shell セッションを開きます。

Cloud Shell を開く

Cloud Shell は、Google Cloud コンソールの下部にあるフレームに表示されます。Cloud Shell を使用してこのプロセスの残りを完了します。
次のコマンドを実行して、この Cloud Shell セッションでのデフォルトの Google Cloud プロジェクトを設定します。
```
gcloud config set project PROJECT_ID
```
PROJECT_ID は、実際の Google Cloud プロジェクト ID に置き換えます。
次のコマンドを実行して、GKE クラスタで使用するサービスアカウントを確認します。
```
gcloud container clusters describe CLUSTER_NAME --zone ZONE \
--format="flattened(nodePools[].config.serviceAccount)"
```
以下を置き換えます。
- CLUSTER_NAME: GKE クラスタの名前。
- ZONE: クラスタが作成されたゾーン。
レスポンスに、クラスタが default という名前のサービスアカウントを使用していることが示される可能性があります。この値は、Compute Engine のデフォルトのサービスアカウントを表します。次のコマンドを実行して、このサービスアカウントの完全な名前を確認します。
```
gcloud iam service-accounts list \
--filter "compute@developer.gserviceaccount.com"
```
Compute Engine のデフォルトのサービスアカウントの詳細を確認してください。
GKE クラスタのサービスアカウントに対するサービスアカウントユーザーのロールをユーザーアカウントに付与します。
```
gcloud iam service-accounts add-iam-policy-binding \
SERVICE_ACCOUNT_NAME \
--member=user:USERNAME \
--role=roles/iam.serviceAccountUser
```
以下を置き換えます。
- SERVICE_ACCOUNT_NAME: 前の手順で確認した GKE クラスタのサービスアカウントの名前。サービスアカウント名は、*@*.gserviceaccount.com という形式になります。
- USERNAME: Google Cloud のユーザー名。
ユーザーアカウントにプロジェクトの GKE クラスタ閲覧者のロールへのアクセス権を付与します。
```
gcloud projects add-iam-policy-binding PROJECT_ID \
--member user:USERNAME --role roles/container.clusterViewer
```
以下を置き換えます。
- PROJECT_ID: Google Cloud プロジェクトの ID。
- USERNAME: Google Cloud のユーザー名。

パイプラインの実行中に十分な権限がない

Google Cloud リソースにアクセスするパイプラインの実行中に、権限不足のエラーが発生することがあります。次に例を示します。

Error executing an HTTP request: HTTP response code 403 with body '{
  "error": {
    "errors": [
      {
       "domain": "global",
       "reason": "insufficientPermissions",
       "message": "Insufficient Permission"
      }
    ],
    "code": 403,
    "message": "Insufficient Permission"
  }
}'

Google Cloud リソースまたは API にアクセスするパイプラインステップでは、Google Kubernetes Engine クラスタとパイプラインで次の処理を行う必要があります。

クラスタには、Google Cloud リソースにアクセスできる Kubernetes Secret が必要です。GKE クラスタの構成の手順で、パイプラインに Google Cloud リソースへのアクセスを許可します。
パイプラインステップでは、Kubernetes Secret へのアクセスが必要であることをパイプライン定義に指定する必要があります。Google Cloud リソースにアクセスするパイプラインステップの定義方法を確認してください。

「サーバーはリクエストの一部しか実行できませんでした」という内容の警告メッセージ

クラスタのアップグレード中または AI Platform Pipelines のデプロイ中に、次のメッセージが表示されることがあります。

Sorry, the server was only able to partially fulfill
your request. Some data might not be rendered.

このメッセージが表示された場合は、5 分ほど待ってからページを更新してください。