デフォルトの Git 統合を使用するプロジェクト

連携

特定の Git リポジトリー内のファイルの同じコンテンツを他のユーザーと共同で操作する場合は、それらのユーザーをコラボレーターとしてプロジェクトに追加できます。 これらのユーザーは、同じ Git リポジトリーに基づいて独自のプロジェクトを作成する必要はありません。 リポジトリーの独自のクローンで作業およびテストを行い、コードの準備ができたら変更をマージすることができます。 プロジェクトにコラボレーターを追加すると、誰がプロジェクトを操作しているかを簡単に追跡できます。 つまり、変更をコミットしているユーザーを確認するために Git ユーザー・インターフェースを確認する必要はありません。

コラボレーターとして追加されることに加えて、ユーザーは、関連付けられたリポジトリーに対する独自のアクセス・トークンを持っている必要があります。

1. ユーザーをコラボレーターとしてプロジェクトに追加し、管理者役割または編集者役割のいずれかを割り当てます。 既存の IBM Cloud Pak for Data アカウントを持つユーザーのみを招待できます。 『コラボレーターの追加』を参照してください。
2. すべてのコラボレーターに、 Git リポジトリーに対する適切なアクセス権を付与します。
3. コラボレーターは、ローカル・クローンの Git ブランチをプルするときに、自分の個人用アクセス・トークンを作成して送信するように求められます。 Git リポジトリーの個人用アクセス・トークンの作成 を参照してください。

デフォルトの Git 統合を使用するプロジェクトで使用できるツールおよび 資産

デフォルトの Git 統合を使用するプロジェクトでは、以下のアクションを実行できません。

• スペースにデプロイ
• プロジェクトのエクスポート
• カタログからの 資産 のインポート
• 空でないプロジェクトへの 資産 のインポート

デフォルトの 統合を使用するプロジェクトで作業する場合、 リポジトリーと同じ リポジトリーを使用する別のプロジェクトから追加された 資産 が 資産 リポジトリーに含まれている可能性があり、 リポジトリーからプルされたすべての を処理することはできません。 GitGitGitGit 詳しくは、 Watson Studio のトラブルシューティング を参照してください。

ローカル・ Git ・データ を選択すると、ローカル・クローンで選択した任意のファイルから データ資産 を作成できます。 例えば、 .csv ファイルを生成するノートブックを実行する場合、これを使用して、 Data Refinery を使用して詳細化できる データ資産 にすることができます。

例えば、 Data Refinery ・フローを保存すると、フロー自体を含む .flow ・ファイルが保存されるだけでなく、プロジェクトはそのフローを指し示す 資産 を作成し、その 資産 のメタデータを持つことができます。 データ・ファイルをアップロードすると、ファイルはプロジェクト・データ・フォルダーにアップロードされ、そのファイルの データ資産 も作成されます。

watsonx ベクトル・データベースまたは Elasticsearch ベクトル・データベースに接続されている Milvus ・インデックスをプロジェクトにインポートする場合は、インポート後、インデックスを使用する前に資格情報を構成する必要があります。 ベクトル索引の資格情報は 15 分間キャッシュに入れられるため、資格情報に対する更新は、キャッシュがリフレッシュされるまで有効になりません。

プロジェクト 資産 とそのメタデータは、 Git リポジトリー内の以下の明確に定義された場所に保管されます。

• assettypes: 資産 のタイプおよびその他の特性を定義する JSON ファイルのセットが含まれます。 このフォルダーに存在するファイルのセット (存在する場合) は、インストールされているサービスのセットによって異なります。

• assets: 資産 に関連するすべてのファイルと、ユーザー指定の情報 (説明など) を含むメタデータ・ファイルが含まれます。 資産 のタイプごとに 1 つのフォルダーがあり、メタデータを含む JSON ファイルが含まれている .METADATA フォルダーがあります。

  例えば、 データ資産 と保存済みモデルの場合、次のように表示されます。

  assets/.METADATA
  assets/.METADATA/wml_model.mymodel1.json
  assets/.METADATA/data_asset.cars.json
  assets/data_asset/cars.csv
  assets/wml_model/mymodel1/7ca4e02d-fe0b-4832-921e-448bf05f435e
  assets/wml_model/mymodel1/3bbb4b08-2d84-4099-8d90-7e9f4fb496f5
  

  ファイル (例えば、メタデータ JSON ファイル) を編集して、 資産 の説明を更新できます。 ただし、これらのファイルを編集する際には注意が必要です。各タイプの 資産 に必要なメタデータは異なり、文書化されていないため、変更が無効な場合に予期しない動作が発生する可能性があります。 これらのディレクトリー内のファイルを手動で削除しないでください。 代わりに、プロジェクト・ユーザー・インターフェースを使用してのみ 資産 を削除してください。

  新しく追加された 資産 のオートディスカバリーはありません。 例えば、有効なモデル・ファイルを ./wml_model に追加した場合 (プロジェクト・ユーザー・インターフェースを使用しない場合)、モデルはプロジェクト内の 資産 として登録されません。

  外部 Git リポジトリーに更新をプッシュする場合は、必ずディレクトリー assettypes および assets の下にあるすべてのファイル (assets/.METADATA を含む) を含めてください。 これらのファイルは、すべての Git ブランチのすべてのコラボレーターに対してプロジェクト 資産 を一貫して管理するために必要です。

ノートブックとスクリプト

ノートブックとスクリプトは、デフォルトの Git プロジェクトではプロジェクト 資産 ではなく、 Watson Studio によって保守される関連メタデータを持ちません。 代わりに、ノートブックとスクリプトは任意のコード・ファイルです。 デフォルトの Git プロジェクト内にも 資産 のバージョン管理はありません。 バージョン管理は、 Git リポジトリーに組み込まれたバージョン管理によって行われます。

Jupyterlab および RStudio でノートブックとスクリプトを開発してテストします。 使用する Git ディレクトリー構造に制限はなく、実行する Git 操作にも制限はありません。

また、 Git リポジトリーに保持しないファイルについては、複製内の .gitignore ファイルの内容を完全に制御できます。 コア・ファイルと ジョブ 実行情報 (メタデータ・ファイルとログ、 assets/.METADATA/job_run.*ファイルや assets/job_runファイルなど) を無視するデフォルトの .gitignore・ファイルが、プロジェクトの作成時に組み込まれます。 他のファイルを無視する場合は、独自の .gitignore ファイルを使用せずに、それらのファイルをデフォルトの .gitignore ファイルに追加する必要があります。

Python 関数は、デフォルトの Git 統合を使用するプロジェクトでは現在サポートされていません。

スクリプトまたはノートブックのジョブ

新規 ジョブを選択することにより、プロジェクトの ジョブページから ジョブ を作成できます。 次に、 ジョブ のエントリー・ポイントとして使用するスクリプトまたはノートブックを参照します。

ジョブ が開始すると、 Git ・クローンの全内容が使用可能 (マウント済み) になります。 エントリー・ポイントとして選択したノートブックまたはスクリプトが、複製内の他のスクリプトまたはノートブックを呼び出し、それらがプロジェクト内の他のファイルを呼び出します。 コード・ベースのジョブの作成 を参照してください。