34 Git統合(プレビュー)

Oracle AI Data Platformインスタンスを接続して、外部Gitリポジトリとの間でデータの取込み、読取りおよび書込みを行うことができます。

AI Data PlatformでのGit統合は、Gitアカウントのログイン資格証明を提供し、データを取り込むための資格証明を使用してGitリポジトリに接続するフォルダを作成することで機能します。複数の資格証明セットを格納して、異なるGitリポジトリに接続したり、同じリポジトリへの様々なアクセス・レベルを管理できます。管理者は、一連の資格証明をユーザーのデフォルト・プロファイルとして選択し、不要になった資格証明を削除できます。

Gitファイルは、AIデータ・プラットフォーム内から完全に管理できます。ユーティリティを使用すると、ファイルをプッシュ、プル、コミットおよびマージしたり、プラットフォームを離れることなく発生したマージ競合を管理したりできます。

AI Data Platformでは、Gitリポジトリからコードを分岐したり、ブランチを切り替えたり、マージしたり、比較したり、削除したりすることもできます。

ノート:

AI Data Platformは現在、GitHub、GitLab、Bitbucket、Oracle Cloud Infrastructure DevOpsなどのパブリックGitプロバイダでホストされているGitリポジトリをサポートしています。お客様のプライベートネットワーク上でホストされるGitのサポートは、今後のアップデートで利用可能になる予定です。

Oracle AI Data PlatformのGitフォルダ(プレビュー)

Oracle AI Data PlatformのGitフォルダを使用すると、プラットフォームを離れることなく、Gitリポジトリでホストされているデータと対話できます。

Gitフォルダは、AIデータ・プラットフォーム設定で設定した資格証明を使用してマスター・カタログに作成されます。フォルダをGitリポジトリに接続し、AI Data Platform UIを使用して、リポジトリ内のファイルをプッシュ、プル、マージ、リベースおよびリセットします。

GitフォルダのRBAC権限を管理して、フォルダを表示できるユーザー、および実行できるGit操作を制御できます。詳細は、Git Folder Permissions (Preview)を参照してください。

円錐パターン・ルール(プレビュー)

Oracle AI Data PlatformのGitコンテンツの疎チェックアウトでは、円錐モードがサポートされます。

Gitのsparse-checkoutコマンドは、スパース・チェックアウトを作成するために使用されます。スパース・チェックアウトは、追跡されたすべてのファイルのサブセットを追跡するように作業ツリーを変更します。AIデータ・プラットフォームでは、sparse-checkoutコマンドでディレクトリを指定するときにConeモードを使用する必要があります。パターンは、リポジトリ・ルート相対フォルダ・パスを表す必要があります。

sparse-checkout円錐パターンで許可される値

コード・モードでは、sparse-checkoutを使用するときにパターンで次の値が許可されます。
  • 空の値これは、ルート・レベルのリポジトリ・ファイルのみを意味します。
  • 空白/空白のみの値。空/ルートのみとして扱われます。
  • リポジトリ・ルートに対するフォルダ・パス:
    • project-a
    • project-a/src
    • notebooks/jobs/
  • 制限付き文字を含まないフォルダ名(次を参照)

sparse-checkout円錐パターンで許可されない値

sparse-checkoutにConeモードを使用する場合、次の値はパターンでは受け入れられません。
値は許可されていません 例
除外パターン !src
コーン以外のglob構文 *.py, src/[abc], src?
絶対/ルート・パス /src, /
円記号 src\main
リポジトリ・ルート・マーカー ., ./
先頭./ ./src
空のパス・セグメント src//main
親のトラバース ../src, src/../main
先頭のダッシュ -src
コントロール文字 例: 改行、改行、NULL文字

円錐モードの制限

sparse-checkoutにConeモードを使用する場合、次の制限が適用されます。

コンポーネント 制限
パターンの数 100パターン
パターンの長さ 1000文字
空パターン 許可

Gitフォルダ・パス

Gitフォルダ・パスは相対パスとして検証されます。各パス・セグメントには、次のもののみを含めることができます。
  • 文字: a-z、A-Z
  • 番号: 0-9
  • アンダースコア: _
  • ハイフン: -
  • ドット: .
  • スペース
  • アットマーク: @
有効なパスは次のようになります。
  • repo
  • repo.name_test-1@dev
  • folder name
  • jobs/git_provider/TASK1
sparse-checkoutで使用されるGitパスでは、次のものは使用できません。
  • 絶対的なパス
  • 親のトラバース
  • 特殊文字: !、#、$、%、*、?、[、]、\、:

Gitフォルダの作成(プレビュー)

外部Gitリポジトリに接続されたOracle AI Data Platformワークスペースにフォルダを作成できます。

  1. ホーム・ページで、ワークスペースに移動します。
  2. 「カタログの作成」アイコン 「作成」をクリックし、「Git folder」をクリックします。右上の「追加」をクリックし、「Git folder」をクリックすることもできます。
  3. 「Git資格証明の選択」ドロップダウン・リストから、Gitリポジトリへのアクセスに必要なGit資格証明を選択します。
  4. GitリポジトリURLを指定します。例: example.git.path。
  5. ワークスペースのGitフォルダの名前を指定します。
  6. Gitリポジトリからブランチを指定して、フォルダに接続します。
  7. クローニングするフォルダの疎チェックアウト円錐形パターンを指定します。このフィールドを空白のままにすると、リポジトリ全体がクローニングされます。
  8. 「作成」をクリックします。

OCI DevOpsリポジトリのGitフォルダの作成(プレビュー)

Oracle Cloud Infrastructureで作成されたDevOpsリポジトリのGitフォルダをOracle AI Data Platformに作成できます。

OCIにDevOpsリポジトリがすでに作成されている必要があります。詳細は、Creating a Repositoryを参照してください。
AIデータ・プラットフォームでDevOpsプロジェクトにアクセスするには、資格証明をすでに作成しておく必要があります。詳細は、資格証明の作成(プレビュー)を参照してください。

ノート:

DevOpsプロジェクトの資格証明を作成する場合、ユーザー名はDevOpsプロジェクトに通常含まれる@tenancynameを除外する必要があります。たとえば、DevOpsプロジェクト・ユーザー名がAcme/oracleidentitycloudservice/alice.jones@acme.comの場合、AIデータ・プラットフォーム資格証明のユーザー名はAcme/oracleidentitycloudservice/alice.jonesです。
  1. ホーム・ページで、ワークスペースに移動します。
  2. 「カタログの作成」アイコン 「作成」をクリックし、「Git folder」をクリックします。右上の「追加」をクリックし、「Git folder」をクリックすることもできます。
  3. 「Git credentials」ドロップダウン・リストから、DevOpsリポジトリへのアクセスに必要なGit資格証明を選択します。
  4. DevOpsリポジトリURLを指定します。たとえば、https://<region>.devops.oci.oraclecloud.com/namespaces/<tenancy>/projects/<project>/repositories/<repo>.gitです。
  5. ワークスペースのDevOpsフォルダの名前を指定します。
  6. DevOpsリポジトリからブランチを指定して、フォルダに接続します。
  7. 「作成」をクリックします。

Gitフォルダの編集(プレビュー)

ワークスペースのGitフォルダの名前と説明を変更できます。

  1. ホーム・ページで、ワークスペースに移動します。
  2. 変更するGitフォルダの横にあるアクションの3つのドット・アイコン 「アクション」をクリックし、「編集」をクリックします。
  3. フォルダの名前および説明を変更します。
  4. 疎チェックアウト円錐パターン・ルールを更新します。
  5. 「保存」をクリックします

Gitフォルダの削除(プレビュー)

自分のGitフォルダをワークスペースから削除できます。

Gitフォルダを削除すると、フォルダおよびコミットされてリポジトリにプッシュされていない変更が削除されます。
  1. ホーム・ページで、ワークスペースに移動します。
  2. 変更するGitフォルダの横にあるアクションの3つのドット・アイコン 「アクション」をクリックし、「削除」をクリックします。
  3. 「削除」をクリックします

Gitフォルダ設定の変更(プレビュー)

ワークスペースのGitフォルダで使用される資格証明およびリポジトリURLを変更できます。

  1. ホーム・ページで、ワークスペースに移動します。
  2. 設定を変更するGitフォルダをクリックします。
  3. 「設定」タブをクリックします。
  4. ドロップダウン・リストから、Gitフォルダの新しい資格証明を選択します。
  5. 新しいGitリポジトリURLを入力します。
  6. 「保存」をクリックします

Gitフォルダ履歴の表示(プレビュー)

「履歴」タブから、Gitフォルダへのコミットの履歴を表示できます。

  1. Gitフォルダに移動し、「Git」タブをクリックします。
  2. 「履歴」タブをクリックします。
  3. 「Git」ボタンをクリックして、Gitサイトでのコミット履歴を表示します。

Gitブランチの作成(プレビュー)

ワークスペースのGitフォルダから既存のブランチから新しいGitブランチを作成できます。

  1. Gitフォルダに移動し、「Git」タブをクリックします。
  2. 「現在のブランチ」ドロップダウン・リストから、新しいブランチの基になるブランチを選択します。
  3. 「ブランチの作成」をクリックします。
  4. 新しいブランチの名前を指定します。
  5. 「作成」をクリックします。

Gitブランチの削除(プレビュー)

Gitブランチは、Oracle AI Data Platformワークスペース内からGitリポジトリから削除できます。

  1. Gitフォルダに移動し、「Git」タブをクリックします。
  2. 「現在のブランチ」ドロップダウン・リストから、削除するブランチを選択します。
  3. 「ブランチの削除」をクリックします。
  4. 削除するすべてのブランチを選択します。
  5. オプション: マージされていないブランチの警告を無視するには、「マージ・ステータスに関係なく削除を強制」を選択します。
  6. 「削除」をクリックします

Git Pull(プレビュー)

ワークスペースのGitフォルダ内からGitプルを実行するブランチを選択できます。

  1. Gitフォルダに移動し、「Git」タブをクリックします。
  2. 「プル」タブをクリックします。
  3. ドロップダウン・リストから、プル元のブランチを選択します。
  4. 「プル」をクリックします。
  5. 競合を解決します。
    • 「ローカルの保持」をクリックして、ローカル・バージョンで上書きします。
    • 「リモートの保持」をクリックして、リモート・バージョンで上書きします。
    • 自分で変更して解決し、「解決済としてマーク」をクリックすることもできます。
    • プル・リクエストを取り消すには、「プルの中止」をクリックします。
  6. コミット・メッセージと、オプションでプルの説明を入力します。
  7. 「コミット・プル」をクリックします。

Gitプッシュ(プレビュー)

ワークスペース内のGitフォルダ内からGitプッシュを実行するブランチを選択できます。

  1. Gitフォルダに移動し、「Git」タブをクリックします。
  2. 「プッシュ」タブをクリックします。
  3. Gitリポジトリにプッシュするファイルを選択します。ファイルをクリックすると、コード・ウィンドウに変更が表示されます。
  4. コミット・メッセージと、オプションでプッシュの説明を入力します。
  5. 「コミット・プッシュ」をクリックします。

Gitブランチをメインにマージ(プレビュー)

メイン・トランク内のブランチは、ワークスペースのGitフォルダ内からマージできます。

  1. Gitフォルダに移動し、「Git」タブをクリックします。
  2. 「マージ」タブをクリックします。
  3. ドロップダウン・リストから、メインとマージするブランチを選択します。
  4. 「マージ」をクリックします。
  5. 競合を解決します。
    • 「ローカルの保持」をクリックして、ローカル・バージョンで上書きします。
    • 「リモートの保持」をクリックして、リモート・バージョンで上書きします。
    • 自分で変更して解決し、「解決済としてマーク」をクリックすることもできます。
    • 「マージの中断」をクリックして、マージ・リクエストを取り消します。
  6. コミット・メッセージと、必要に応じてマージの説明を入力します。
  7. 「マージのコミット」をクリックします。

Git Rebase (プレビュー)

Gitフォルダ内のブランチをリベースして、そのGitブランチから別のブランチに変更を適用できます。

ノート:

ブランチをリベースするには、強制プッシュが必要です。強制的にプッシュすると、リモートリポジトリの履歴が変更され、同じリポジトリで作業しているコラボレータのバージョン管理の問題が発生する可能性があります。
  1. Gitフォルダに移動し、「Git」タブをクリックします。
  2. 「Rebase」タブをクリックします。
  3. 「現在のブランチ」ドロップダウン・リストから、リベースするブランチを選択します。
  4. 「リベース先ブランチ」ドロップダウン・リストから、現在のブランチのリベース先のブランチを選択します。
  5. 「リベースの確認」を選択します。
  6. 「リベース」をクリックします。

Git Reset (プレビュー)

Gitフォルダ内のブランチをリセットして、そのブランチの内容を以前の状態に戻すことができます。

ノート:

ブランチをリセットするには、強制プッシュが必要です。強制的にプッシュすると、ワークスペースとリモート・リポジトリの両方で、現在のブランチの履歴が変更されます。ブランチの履歴が削除され、リモート・リセット・ブランチの履歴にリセットされます。
  1. Gitフォルダに移動し、「Git」タブをクリックします。
  2. 「Reset」タブをクリックします。
  3. 「現在のブランチ」ドロップダウン・リストから、リセットするブランチを選択します。
  4. 現在のブランチを"main"にリセットするリモート・ブランチを選択ドロップダウン・リストから、現在のブランチをリセットするリモートGitリポジトリのブランチを選択します。
  5. 「Confirm hard reset」を選択します。
  6. 「リセット」をクリックします。