メインコンテンツまでスキップ

Azure に JupyterLab をインストールする

使用するには Azure Portal から JupyterLab と AI Unlimited カーネルをインストールするための、Teradata が提供する Azure Resource Manager (ARM) テンプレート。

これにより、サーバー インスタンスがデプロイされ、JupyterLab は systemdによって制御されるコンテナ内で実行されます。

ヒント

インストールに関するサポートについては、 サポート チーム にメールを送信するか、 コミュニティにお問い合わせください。

Azureアカウントを準備する​

  • クラウド管理者と貢献して、 JupyterLab テンプレートで定義されているクラウド リソースを作成するために必要なアクセス許可が Azure アカウントにあることを確認します。

  • ネットワーク要件: Azure リソース グループ には サブネットが構成されたAzure Virtual Network (VNet) が必要です。アカウントのアクセス許可に応じて、既存の VNet またはサブネットを使用するか、独自の VNet またはサブネットを作成します。

  • コマンドを実行したりデバッグしたりするために JupyterLab インスタンスにアクセスする必要がある場合は、 キー ペア を使用してセキュア シェル (SSH) で安全に接続できます。 インスタンスの詳細を指定するときに、キー ペアが必要になります。

リポジトリをクローンする​

Teradata が提供する AI Unlimited GitHubリポジトリ 内の deployments フォルダには、AI Unlimited をインストールするためのテンプレート、パラメータ、およびポリシー ファイルが含まれています。

ターミナル ウィンドウを開き、リポジトリをクローンします。

Jupyterテンプレートを見つける​

JupyterLab の ARM テンプレートは、AI Unlimited GitHub リポジトリにあります。

deployments/azure/templates/arm/jupyter

ロード バランサ を使用するかどうか、およびどのタイプを使用するかに基づいてテンプレートを選択します。

注記

組織のクラウド管理者にガイダンスを依頼することをお勧めします。

テンプレートを読み込む​

  1. Azure Portalにサインインします。
    注記

    Azure Portal への参照は、2024 年 5 月 29 日時点で最新です。

  2. カスタム デプロイを検索し、 カスタム テンプレートのデプロイを選択します。
  3. エディターで独自のテンプレートを作成するを選択し、次に ファイルの読み込みを選択します。
  4. 使用するテンプレートファイルを選択し、 保存を選択します。

インスタンスの詳細を指定する​

パラメータを確認します。必要なパラメータの値を指定します。組織によっては他のパラメータが必要になる場合があります。

Azure と JupyterLab のパラメータ
パラメータ説明注意事項
SubscriptionAI Unlimited のデプロイに使用する Azure サブスクリプション。必須
デフォルト: NA
無料トライアルではないアカウントを使用することをお勧めします。
RegionAI Unlimited をデプロイするリージョン。必須
デフォルト: NA
作業場所に最も近い Azure リージョンと、AI Unlimited で使用するデータ リソースを選択します。
Resource Group Name関連する AI Unlimited リソースをグループ化するコンテナの名前。必須
デフォルト: ai-unlimited-jupyter
OS Version現在のサブスクリプションで利用可能なオペレーティング システムのバージョン。オプション デフォルト
デフォルト: Ubuntu-2004
Instance TypeAI Unlimited に使用するインスタンス タイプ。オプション
デフォルト: STANDARD_D2_V3
コストを節約するには、デフォルトのインスタンス タイプを使用することをお勧めします。デフォルトのインスタンス タイプは、2 つの vCPU と 8.0 GiB のメモリを備えた標準の Dv3 シリーズです。
NetworkAI Unlimited インスタンスをデプロイするネットワークの名前。オプション
デフォルト: NA
SubnetAI Unlimited インスタンスをデプロイするサブネットワーク。必須
デフォルト: NA
サブネットは、選択した可用性ゾーンに存在する必要があります。
Security Groupインスタンスへの受信トラフィックと送信トラフィックを制御する仮想ファイアウォール。オプション
デフォルト: JupyterSecurityGroup
セキュリティ グループは、インスタンスへのアクセスを許可するプロトコル、ポート、IP アドレスまたは CIDR ブロックを指定する一連のルールとして実装されます。カスタム セキュリティ グループ イングレス ルールを作成しない限り、受信トラフィックを許可するには、アクセス CIDR またはセキュリティ グループの少なくとも 1 つを定義します。
Access CIDRインスタンスへのアクセスが許可される CIDR IP アドレスの範囲。オプション
デフォルト: 0.0.0.0/0
この値は信頼できる IP 範囲に設定することをお勧めします。カスタム セキュリティ グループ イングレス ルールを作成しない限り、受信トラフィックを許可するには、アクセス CIDR またはセキュリティ グループの少なくとも 1 つを定義します。
Source App Sec Groups (ASG)AI Unlimited インスタンスに接続する権限を持つソース アプリケーション セキュリティ グループ。ASG を使用すると、特定のネットワーク セキュリティ ポリシーに基づいて仮想マシン (VM) を整理できます。これらのセキュリティ ポリシーによって、仮想マシンで許可されるトラフィックと許可されないトラフィックが決まります。オプション
デフォルト: NA
ネットワーク インターフェイスと同じリージョン内のアプリケーション セキュリティ グループを選択します。
Destination App Sec GroupsAI Unlimited インスタンスに接続する権限を持つ宛先アプリケーション セキュリティ グループ。オプション
デフォルト: NA
ネットワーク インターフェイスと同じリージョン内のアプリケーション セキュリティ グループを選択します。
Role Definition IDAI Unlimited で使用するロールの ID。必須
既定値: NA
Azure CLI コマンド Get-AzRoleDefinition を使用して、ロール定義 ID を取得します。
Allow Public SSHAzure 内の VM に接続するためにセキュア シェル (SSH) キーを使用できるかどうかを指定します。オプション
デフォルト: true
Public KeySSH 経由で VM に接続するために使用できる公開 SSH キー。オプション
デフォルト: NA
この値は ssh-rsa で始まる必要があります。
Use Persistent Volumeデータの保存に新しい永続ボリュームを使用するか、既存の永続ボリュームを使用するかを指定します。パラメータ セクションの下の「詳細: 永続ボリュームの使用」を参照してください。オプション、デフォルト
デフォルト: 新規
サポートされるオプションは、使用ケースに応じて、新しい永続ボリュームまたは既存のボリュームです。
Persistent Volume Sizeインスタンスに接続できる永続ボリュームのサイズ（GB 単位）。オプション
デフォルト: 100
8 ～ 1000 までの値をサポートします。
Existing Persistent Volumeインスタンスに接続できる既存の永続ボリュームの ID。永続ボリュームの使用が既存に設定されている場合は必須です
デフォルト: NA
永続ボリュームは、AI Unlimited インスタンスと同じアベイラビリティーゾーンに存在する必要があります。
JupyterHttpPortJupyterLab サービス UI にアクセスするためのポート。デフォルトで必須
デフォルト: 8888
JupyterVersionデプロイする JupyterLab のバージョン。デフォルトで必須
デフォルト: latest
値は、latest などのコンテナ バージョン タグです。
JupyterTokenUI から JupyterLab にアクセスするために使用されるトークンまたはパスワード。必須
デフォルト: NA
トークンは文字で始まり、英数字のみで構成されている必要があります。 許可されるパターンは ^[a-zA-Z][a-zA-Z0-9-]* です。
もっと学ぶ.: 永続ボリュームの使用

JupyterLab インスタンスはコンテナ内で実行され、その構成データをインスタンスのルート ボリュームのデータベースに保存します。このデータは、インスタンスをシャットダウン、再起動、またはスナップショットを作成して再起動しても保持されます。

ただし、永続ボリュームには、コンテナ化されたアプリケーションのデータが、それが実行されるコンテナ、ポッド、またはノードの有効期間を超えて保存されます。

永続ボリュームなし

コンテナ、ポッド、またはノードがクラッシュまたは終了すると、JupyterLab 構成データが失われます。新しい JupyterLab インスタンスをデプロイすることはできますが、失われたインスタンスと同じ状態にすることはできません。

永続ボリュームの場合

コンテナ、ポッド、またはノードがクラッシュまたは終了し、JupyterLab 構成データが永続ボリュームに保存されている場合は、失われたものと同じ構成を持つ新しい JupyterLab インスタンスをデプロイできます。

例

  1. JupyterLab をデプロイし、次のパラメータを含めます。
    • UsePersistentVolume: New
  2. スタックを作成したら、出力 タブで volume-id をメモします。
  3. JupyterLab を使用します。
  4. JupyterLab インスタンスが失われた場合は、JupyterLab を再度デプロイし、次のパラメータを含めます。
    • UsePersistentVolume: New
    • ExistingPersistentVolumeId: 手順 2 でメモした値

新しい JupyterLab インスタンスは、失われたインスタンスと同じ構成になります。

インスタンスを作成する​

  1. レビュー + 作成を選択します。
  2. 作成を選択します。.
    通知 ページでは進行状況を監視できます。

デプロイが完了すると、 出力 ページに JupyterLab にアクセスするための URL が表示されます。

興味深い記事