アーティファクト レジストリ

備考

プレビュー

この機能は パブリック プレビュー段階です。ワークスペース管理者は、 プレビュー ページから Databricks アーティファクト Registry へのアクセスを制御できます。Databricksのプレビューを管理を参照してください。

注記

Databricks は、アーティファクトレジストリが一般提供されるようになったときに価格を発表します。

アーティファクトレジストリ は、コンテナーイメージを管理対象アセットとして Unity Catalog に格納します。イメージは Unity Catalog メタストアと同じリージョンに格納されます。標準的な Docker コマンドを使用してイメージをプッシュし、Unity Catalog 権限でアクセスを制御し、サポートされている Databricks ワークロードでイメージを利用できるようにするために使用します。

主要な概念

• アーティファクト： Unity Catalogに保存された名前付きコンテナ・イメージで、catalog.schema.artifactという3階層の名前で識別されます。
• タグ： catalog.schema.artifact:tagの形式を使用してアーティファクトのバージョンを指す、変更可能なエイリアス。タグを再度プッシュすると、タグが解決するバージョンが変更される場合があります。再現可能なデプロイを行うためには、latestなどの変更可能なタグの使用を避け、ワークロードがダイジェスト参照を受け入れる場合はダイジェストを参照してください。
• イメージ ダイジェスト： アーティファクトの特定のバージョンに対する、不変でコンテンツ アドレス指定可能な識別子。
• 画像アクセラレーション: 対象となるイメージを アーティファクトレジストリ にプッシュした後に、Databricks が自動的に適用する最適化です。このプロセスでは、サポートされているワークロードのプルレイテンシーを削減するように設計された形式に画像が変換されます。アーティファクトバージョンの画像アクセラレーションステータスを確認するには、画像アクセラレーションステータスの確認を参照してください。

アーティファクトレジストリの仕組み

パブリッシャーとユーザーは、次のライフサイクルを通じてアーティファクトレジストリのコンテナーイメージを操作します：

1. ビルドとプッシュ: パブリッシャーはイメージをビルドし、catalog.schema.artifact:tag の形式の 3 レベルの Unity Catalog 名でタグ付けし、ワークスペース レジストリにプッシュします。アーティファクト名の要件と イメージのプッシュを参照してください。
2. ガバナンス: アーティファクト Registry は、指定された Unity Catalog のカタログおよびスキーマの下に画像を保存します。Unity Catalog の権限により、画像を公開、検出、および読み取りできるユーザーを制御できます。権限の付与を参照してください。
3. 発見: ユーザーは Software Artifacts API を呼び出して、利用可能な画像やバージョンを検出し、画像アクセラレーションのステータスを確認します。画像とバージョンの検出を参照してください。
4. 使用方法： ユーザーは、カスタムコンテナーイメージを実行するジョブなど、サポートされている Databricks ワークロードを作成するときにイメージを参照します。サポートされている Databricks ワークロードでのイメージの使用を参照してください。

制限事項

次の制限が適用されます：

可用性

• ワークスペースと、その Unity Catalog メタストアは同じリージョンヌに存在する必要があります。リージョンが異なる場合、そのワークスペースから アーティファクトレジストリ を使用することはできません。

• アーティファクトレジストリは、次のリージョンで使用できます。

  • asia-south1
  • asia-southeast1
  • europe-west1
  • europe-west2
  • europe-west3
  • us-central1
  • us-east1
  • us-east4
  • us-west1

サポート対象の用途

• アーティファクトレジストリのイメージは、サポートされている Databricks ワークロードでのみ使用できます。サポートされている Databricks ワークロードでのイメージの使用を参照してください。
• Docker または他のレジストリ クライアントを使用してこれらのイメージをプルしたり、イメージのBLOBを直接ダウンロードしたりすることはできません。

認証

• ワークスペースのDocker認証に使用されるOAuthアクセストークンの有効期間は1時間です。時間がかかるプッシュは、有効期限の経過後にアップロードされたレイヤーの承認に失敗する場合があります。Docker認証情報ヘルパーが新しいトークンをリクエストするように、プッシュを再試行してください。

画像アクセラレーション

• 30 GBを超える画像は、画像アクセラレーション用に変換できません。
• 画像アクセラレーションでは、失敗した変換状態は公開されません。詳細については、画像アクセラレーションステータスの確認を参照してください。

ディスカバリーと管理

• Catalog Explorerには、画像のインターフェースが用意されていません。
• レジストリエンドポイントは、Open Container Initiative（OCI）のタグリストリクエストまたは削除リクエストをサポートしていません。
• Software Artifacts API は、10個を超えるタグが同じダイジェストを指している場合、バージョンに対して最大10個のタグを返します。

アーティファクト名

• アーティファクト名には、文字とフォーマットに関する制限があります。アーティファクト名の要件を参照してください。

監査ロギング

Artifact Registryは、アーティファクトの検出、所有権の変更、イメージのプッシュおよびプルをワークスペース監査Logsに記録します。これらのイベントはservice_name値unityCatalogを使用します。イベント名とリクエストパラメーターについては、アーティファクト Registryイベントを参照してください。

system.access.auditでこれらのイベントをクエリーするには、 監査ログ システムテーブルリファレンスを参照してください。

その他のリソース

• 認証の構成、アクセスの付与、イメージのプッシュ、およびそのバージョンの検索を行うには、アーティファクトレジストリの使用開始を参照してください。
• 一般的なプレビューアクセス、認証、プッシュ、検出、およびイメージアクセラレーションの問題を解決するには、アーティファクトレジストリのトラブルシューティングを参照してください。