Git フォルダー サーバーレス

Important

この機能は ベータ版です。

Git フォルダー Serverless は、ノートブックやファイルを含むGitフォルダ内の資産間で共有される単一のサーバーレス計算リソースを提供します。 新しいサーバーレス計算リソースを起動したり、すべてのノートブックやファイルに環境を設定したりせずに、マルチファイルのオーサリングにGit Folder Serverlessを使いましょう。 環境はGitフォルダのルートにある pyproject.toml ファイルによって管理されています。

必要条件

Gitフォルダーのサーバーレスを使う方法:

  • プロジェクトは Gitフォルダに入っている必要があります。
  • GitフォルダはGitフォルダエディターで開く必要があります。
  • Gitフォルダにルート pyproject.toml ファイルが含まれている場合、 environment_version は 5 以降に設定されなければなりません。

共有計算および環境

  • 同じGitフォルダ内のノートブックとファイルは、1つのGitフォルダーのサーバーレス計算リソースに接続し、 pyproject.tomlが管理する環境を利用します。
  • 関連するGitフォルダ内のアセットのみがコンピュートリソースにアタッチできます。
  • あるノートブックで定義されたPython変数は、別のノートブックでは利用できません。
  • Gitフォルダ内の任意のノートブックやファイルから開く ウェブ端末 は、同じコンピュートリソース上で動作します。

GitフォルダのサーバーレスをGitフォルダエディターで使ってください

  1. ワークスペースのサイドバーで「 Workspace 」をクリックし、Gitフォルダに移動します。

  2. エディターで開くをクリックします。

  3. Gitフォルダ内のノートブックやファイルを開きます。

  4. 計算ドロップダウンメニューをクリックしてください。

  5. Gitフォルダー Serverless を選択します。

    Computeドロップダウンメニューに、環境バージョン5でGitフォルダーServerlessが選択されている表示があります

  6. ノートブックやファイルを実行してコンピュートリソースを起動します。

同じ計算を別のアセットから使うには、同じGitフォルダ内の別のノートブックやファイルを開き、「 Git Folder Serverless」を選択してください。 資産は計算と環境を共有し、 pyproject.tomlが管理します。

pyproject.tomlで環境を管理

GitフォルダーServerlessは、フォルダのルートにpyproject.tomlファイルを付けて、Gitフォルダ全体のPython依存関係を管理します。 これは、 環境 側のペインで設定された依存関係が1つのノートブックに適用される標準的なサーバーレスノートブックとは異なります。

依存関係を追加したり、ノートブックのコマンドや pyproject.toml編集で環境変更を適用したりできます。

ノートブック コマンドを使用する

  1. Git Folder Serverless に関連付けられたノートブックを開く。

  2. Gitフォルダのルートに pyproject.toml ファイルが存在するか確認してください。 もし存在しなければ、 環境 側のペインを開いて 「Create pyproject.toml」をクリックしてください。

  3. ルートpyproject.tomlファイルに依存関係を追加する%uv add <package>実行してください。 例えば次が挙げられます。

    %uv add cowsay

  4. %uv syncを実行して依存関係を共有環境に適用し、uv.lockを生成または更新します。

    %uv sync

編集 pyproject.toml

  1. Gitフォルダエディターで、Gitフォルダのルートに pyproject.toml ファイルが存在するか確認してください。 もし存在しなければ、 環境 側のペインを開いて 「Create pyproject.toml」をクリックしてください。

  2. pyproject.toml ファイルを開きます。

  3. dependenciesリストを手動で編集してください。 例えば次が挙げられます。

    [project]
name = "my-project"
version = "0.1.0"
dependencies = [
  "simplejson==3.18.1",
]

[tool.databricks.environment]
environment_version = "5"

  4. pyproject.tomlファイルエディターの上部で「適用」をクリックして、環境変更をGitフォルダーServerlessに適用します。

更新された環境は、同じGitフォルダーサーバーレスコンピュートに接続されたノートブックやファイルに対して利用可能です。 環境をチェックするには、 環境 サイドのペインを開きます。 サーバーレス環境のバージョンやインストールされた依存関係に関する情報は 「サーバーレス環境の設定」 を参照してください。

Gitを通じたコラボレーション

Gitフォルダーのサーバーレス計算リソースを起動したユーザーだけがワークロードを実行できます。 同じGitフォルダを他のユーザーが開くと、既存のコンピュートリソース上でノートブックやファイルの実行がブロックされます。

Databricksは、各コラボレーターがリポジトリを自分の個人ワークスペースフォルダ内のGitフォルダに クローン することを推奨しています。 各コラボレーターは、クローン用に pyproject.toml が管理する別の計算リソースと環境を割り当てます。

ブランチ、コミット、プッシュ、プルを使ってリモートGitリポジトリを通じて変更を交換します。 「 Gitフォルダでのコラボレーション」を参照してください。

Limitations

  • コンピュート共有は サーバーレス使用ポリシーに限定されています。 同じGitフォルダ内のノートブックやファイルで、異なる使用ポリシーを使う場合は、共有するのではなく、別々の計算リソースが割り当てられます。

その他のリソース

  • Last updated on