このページは Cloud Translation API によって翻訳されました。

SSH で JupyterLab にアクセスする

HTTPS 経由で JupyterLab インスタンスにアクセスできない場合、SSH を使用して接続を確立する必要があります。

SSH ポート転送を設定するには、次の手順を行い、ローカルブラウザから JupyterLab セッションにアクセスします。

任意のターミナルまたは Cloud Shell で、Google Cloud CLI を使用して次のコマンドを実行します。
```
gcloud compute ssh INSTANCE_NAME \
    --project PROJECT_ID \
    --zone ZONE \
    -- -NL 8080:localhost:8080
```
次のように置き換えます。
- INSTANCE_NAME: インスタンスの名前
- PROJECT_ID: Google Cloud プロジェクト ID
- ZONE: インスタンスが配置されているゾーン
ローカルブラウザから JupyterLab セッションにアクセスします。
- ローカルマシンでコマンドを実行した場合は、https://localhost:8080 で JupyterLab にアクセスします。
- Cloud Shell を使用してコマンドを実行した場合は、ポート 8080 の [ ウェブプレビュー] で JupyterLab にアクセスします。

HTTPS アクセスを使用できない理由

HTTPS で JupyterLab にアクセスするには、Vertex AI Workbench インスタンスが Google Cloud プロキシサービスにアクセスできる必要があります。インスタンスは、起動時に自身をプロキシサービスに登録します。プロキシアクセスに失敗した場合、インスタンスは SSH 経由で JupyterLab にアクセスするように求めます。

HTTPS 経由で JupyterLab にアクセスできない一般的な理由は次のとおりです。

JupyterLab インスタンスのプロキシモードのメタデータ設定が正しくない
JupyterLab ノートブックを実行している仮想マシン（VM）のインターネットアクセスをブロックするようにネットワークが構成されている
インスタンスに外部 IP アドレスがない
VPC Service Controls の設定で Artifact Registry へのアクセスがブロックされている

以下のセクションでは、これらの問題を解決する方法について説明します。

変更を有効にするために、ノートブックの VM を再起動してこれらの問題を解決する必要があります。

JupyterLab インスタンスのプロキシモードのメタデータ設定が正しくない

デフォルトでは、Vertex AI Workbench インスタンスを作成すると、Vertex AI Workbench がプロキシモードのメタデータ設定を追加します。プロキシモードのメタデータ設定を変更または削除すると、インスタンスはプロキシサービスに接続できなくなります。

プロキシモードのメタデータ設定が有効であることを確認するには、次の操作を行います。

Google Cloud コンソールで、[インスタンス] ページに移動します。

[インスタンス] に移動
変更するインスタンスを選択します。
[VM の詳細を表示] の横にある [Compute Engine で表示] をクリックします。
[VM インスタンスの詳細] ページで、[編集] をクリックします。
[メタデータ] セクションで、メタデータを追加または変更して、プロキシモードのエントリを正しい値（project_editors など）に設定します。
[保存] をクリックします。

ネットワークがインターネットアクセスをブロックしている

JupyterLab インスタンスは、公開 URL を介してプロキシサービスにアクセスします。Virtual Private Cloud のネットワーク設定で公共のインターネットへのアクセスがブロックされている場合や、ファイアウォールルールで下り（外向き）トラフィックがブロックされている場合は、SSH を使用して Vertex AI Workbench インスタンスにアクセスする必要があります。公共のインターネットを介したインスタンスへのアクセスを可能にするには、ネットワーク管理者およびファイアウォール管理者と連携することが必要になる場合があります。

インスタンスに外部 IP アドレスがない

Vertex AI Workbench インスタンスが外部 IP アドレスなしで作成されていることがあります。これを変更するには、次の操作を行います。

Google Cloud コンソールで、[インスタンス] ページに移動します。

[インスタンス] に移動
変更するインスタンスの名前をクリックします。
[VM の詳細を表示] をクリックします。
[編集] をクリックします。
[ネットワークインターフェース] セクションで、外部 IP アドレスを割り振るネットワークを開きます。
[外部 IP アドレス] プルダウンメニューをクリックし、オプションを選択します。この問題を解決するには、[なし] を選択しないでください。
[ネットワークインターフェース] セクションで、[完了] をクリックします。
[保存] をクリックします。

VPC Service Controls の設定で Artifact Registry へのアクセスがブロックされる

プロキシサービスに接続するために、Vertex AI Workbench インスタンスは、Artifact Registry からエージェントをダウンロードして実行します。このエージェントがないと、インスタンスはプロキシサービスに接続できません。

VPC Service Controls の設定で Artifact Registry へのアクセスをブロックしている場合は、Artifact Registry サービスを VPC Service Controls のサービス境界に追加する必要があります。詳細については、サービス境界の動作と VPC Service Controls を使用して保護するサービスをご覧ください。

詳細なトラブルシューティング

上記の手順でも接続できない場合は、仮想マシンのコンソールログを確認してみてください。これらのログは、Vertex AI Workbench インスタンスがプロキシサービスに登録できない理由を調べる際に有用な可能性があります。

ログにアクセスするには、次の操作を行います。

Google Cloud コンソールで、[インスタンス] ページに移動します。

[インスタンス] に移動
トラブルシューティングするインスタンスを選択します。
[ログ] で、[シリアルポート 1（コンソール）] をクリックします。

次のステップ

その他の問題を解決するヒントについては、Vertex AI Workbench インスタンスのトラブルシューティングセクションをご覧ください。