Use Git repositories¶

Notebooks are represented as .ipynb files in a codespace, which allows you to version both your notebook and non-notebook files using an external Git repository. Gitリポジトリから新しいcodespaceを初期化するだけでなく、アクティブなセッション中に、codespaceの統合 ターミナルで Git CLIを直接使うこともできます。 DataRobotはGitプロバイダーと連携しているため、codespaceでコードを開発する際に、コードのバージョン管理やチームでの共同作業を行うことができます。

Gitプロバイダーとの連携¶

Integrate DataRobot with your Git provider to allow DataRobot to access your repositories using the OAuth 2.0 standard. Gitプロバイダーと連携するには、ユーザーアイコンをクリックし、OAuthプロバイダーの管理のページを選択します。

OAuthプロバイダーの管理のページから、連携したいプロバイダーを選択します。 DataRobotでは、GitHub Cloud、GitLab Cloud、Bitbucket Cloud、MicrosoftのAzure Repos、GitLab Enterprise Self-Managed（オンプレミスおよびSTS環境用）との連携をサポートしています。 この連携設定は、Gitプロバイダーのアカウントごとに一度だけ行う必要があります。 以下の例では、GitHub Cloudでの認証の概要を示します。

After choosing a provider, click the actions menu icon () and select Authorize on github.com (the URL will change depending on the provider selected).

プロバイダーのログインページにリダイレクトされます。 アカウントにサインインし、DataRobotのアクセスを認可します。

Once authorized, DataRobot redirects you to the Git providers page.

Manage Git provider integrations¶

GitプロバイダーのアカウントにインストールされたDataRobotアプリに対する権限を表示および管理するには、対応するプロバイダーのメニューアイコンに移動し、github.comで管理をクリックします（URLは選択したプロバイダーによって変わります）。 これにより、対応するGitプロバイダーサイトにリダイレクトされ、認可とアクセス権限の設定が表示されます。

以下の表は、一般的なOAuthプロバイダーの認可を管理する場所のリストです。

To remove DataRobot's authorization to your Git provider account, click Revoke authorization. DataRobotはアカウントにアクセスできなくなり、関連付けられているすべてのメタデータを削除します。 ただし、APIの制限により、DataRobotが認可を完全に取り消すことができないため、DataRobotアプリがGitプロバイダーの認証済みアプリに表示される場合があります。

For GitLab and Bitbucket, once you’ve removed authorization, you must complete an additional step in the provider's settings to revoke authorization of the DataRobot OAuth app. For example, in GitLab, revoke the authorization on the Applications page in the GitLab user settings.

Gitプロバイダーのサイトで認可を取り消しても、DataRobotの設定では取り消していない場合、次回、対応するGitアカウントのリポジトリに対するcodespaceでGit操作を使用すると、認可が期限切れとして検出されます。 この連携を再び使用するには、そのGitプロバイダーアカウントに対してDataRobotを再認可する必要があります。

Git CLIを使用した開発¶

Gitプロバイダーに対してDataRobotを認可したら、ターミナルからcodespaceセッションでGit CLIを使い始めることができます。 DataRobotがユーザーに代わって自動的に認証を処理するため、Git CLIコマンドを実行するたびに個人用アクセストークン（PAT）を使用してGitアカウントを手動で認証する必要はありません。 DataRobotは、バックグラウンドでカスタムのGit資格情報ヘルパーを使用してこれを実現しています。

Git認証は個々のユーザーレベルで処理されます。 複数のユースケースメンバーがユースケース内の同じ共有codespaceにアクセスできる場合でも、DataRobotは、アクティブなcodespaceセッションを開始したユーザーの代わりに、そのユーザーの認可されたGitプロバイダーアカウントに基づいてのみ認証を試みます。

リモートGitリポジトリのクローンを作成し、それらのリポジトリとの間で変更内容をプッシュおよびプルするだけで、追加の認証手順は必要ありません。

git clone https://github.com/<my-account>/<my-repo>
git pull 

カスタム環境でcodespaceを使用している場合、Git連携機能では、プライベートGit認証用のDataRobot Gitヘルパーバイナリをカスタム環境イメージに含める必要があります。

# Install the Git helper binary used for private git authentication in notebooks and codepaces
RUN curl -L -o drgithelper https://github.com/datarobot-oss/drgithelper/releases/download/v0.0.9/drgithelper && chmod +x drgithelper 

カスタム環境を設定するためのDockerfileの設定方法のエンドツーエンドの例として、サンプル環境のテンプレートを使用できます。

Gitリポジトリからcodespaceを作成する¶

既存の外部Gitリポジトリのコードでインスタンス化された新しいcodespaceを作成する場合は、ユースケースに移動して、追加 > Codespace > Codespaceをアップロードを選択します。

パブリックリポジトリのクローンを作成する場合は、GitクローンのURLを指定します（対応するGitプロバイダーとの連携を追加している必要はありません）。

プライベートリポジトリからcodespaceを作成するには、プライベートリポジトリタブを選択し、ドロップダウンからプロバイダーを選択します。 ここに表示されるのは、すでに認可済みのプロバイダーだけです。

クローンを作成したいリポジトリを選択します。 デフォルトでは、最近更新されたリポジトリがリポジトリドロップダウンに表示されます。 特定のリポジトリを検索するには、検索フィールドに入力します。

Gitリポジトリから新しいcodespaceを作成するだけでなく、codespaceターミナルでGit CLIを使用して、既存のcodespaceにGitリポジトリを直接複製することもできます。

次のステップ¶

With a codespace session running, automate notebook runs on a schedule or use the integrated terminal to manage your environment further.

• Start a session: Start a codespace session.
• Codespace scheduling: Automate code-based workflows by scheduling notebooks in a codespace to run in non-interactive mode.
• Notebook terminals: Use the integrated terminal to run shell commands, install packages, and execute scripts in a codespace session.
• Manage the notebook environment: Configure the resource type, environment image, and inactivity timeout for a codespace session.