アーティファクト・レジストリのトラブルシューティング
ベータ版
この機能は ベータ版です。使用するには、ワークスペース管理者が [プレビュー] ページから Databricks Artifact Registry を有効にする必要があります。Databricks のプレビューを管理するを参照してください。Databricks は、アーティファクト Registry が一般提供されるようになったときに価格を発表します。
このページを使用して、Artifact Registryに関する一般的な問題を解決します。完全なセットアップおよびイメージプッシュのワークフローについては、「Artifact Registryの使用開始」を参照してください。
ベータ版アクセスに関する問題
アーティファクト Registryが有効になっていません
ワークスペース管理者に依頼して、ワークスペースの [ プレビュー ] ページで Databricks アーティファクト レジストリ を有効にしてもらってください。プレビューを利用できない場合は、ワークスペースがアーティファクト レジストリをサポートしているリージョンにあることを確認してください。制限事項を参照してください。
Preview status is temporarily unavailable
操作を再試行してください。エラーが解決しない場合は、サポートをリクエストする際にエラーの詳細と、存在する場合はリクエスト ID を収集してください。
Docker authentication issues
The Docker authentication コマンド is unavailable
Install or update the Databricks CLI (command-line interface) to the minimum supported version in Prerequisites, then run databricks auth docker configure again.
Dockerでレジストリの資格情報を取得できません
ワークスペースの OAuth プロファイルを作成または更新し、レジストリリージョン用に Docker を構成してから、Docker 操作を再試行します。次のコマンドを実行します。
databricks auth login --profile <profile>
databricks auth docker configure --profile <profile> --region <region>
<profile>が目的のワークスペースを指していることを確認します。default プロファイルを使用する場合は、Docker 認証コマンドから --profile <profile> を省略します。
The Docker credential helper does not support profiles that use personal アクセストークンs, OAuth machine-to-machine (M2M) credentials, or アカウントのみの認証.For the complete authentication ステップ, see Set up Docker authentication.
長時間実行されるプッシュで認証エラーが返されます
Docker認証情報ヘルパーは、有効期間の短いワークスペースのOAuthアクセストークンを提供します。長時間実行されるプッシュによって認可エラーが返された場合は、認証情報ヘルパーが新しいトークンを要求するようにdocker pushを再試行してください。認証情報の有効期間については、制限事項をご覧ください。
The registry ホスト名 or region does not match
レジストリのホスト名が、databricks auth docker configure に渡したクラウドおよびリージョンに対応していることを確認します。また、選択した Databricks CLI プロファイルが目的のワークスペースを指していることを確認してください。プッシュを再試行する前に、イメージに正しい レジストリ ホスト名 を再タグ付けします。
イメージプッシュの問題
プッシュで権限エラーが返される
プッシュ操作に必要な権限をプリンシパルが持っていることを確認します。権限の付与を参照してください。
画像名が却下されました
<registry-hostname>/<catalog>.<schema>.<artifact>:<tag>形式を使用します。アーティファクトセグメントの要件については、アーティファクト名の要件を参照してください。
カタログまたはスキーマが存在しません
Artifact Registryは、カタログやスキーマを作成しません。ターゲットのカタログとスキーマがUnity Catalogにすでに存在し、ワークスペースからアクセス可能である必要があります。存在しないオブジェクトを作成するか、既存のカタログとスキーマを使用し、プッシュを再試行する前に必要な権限を確認してください。
画像ディスカバリーに関する問題
画像またはバージョンが表示されません
Confirm that the Docker push completed successfully and that you are listing the same catalog, schema, and アーティファクト name that you pushed.Use the ソフトウェア アーティファクト API rather than the registry Endpoint to list アーティファクト and versions.See Discover images and versions.
レジストリ操作はサポートされていません
レジストリEndpointはこの操作をサポートしていません。Software Artifacts API を使用して、画像とバージョンを検索します。制限事項については、制限事項を参照してください。
画像高速化の問題
Image acceleration remains UNSPECIFIED
UNSPECIFIED は失敗を識別しません。画像サイズの制限など、画像アクセラレーションの対象となる条件については、制限事項を参照してください。対象となる大きい画像ほど、変換に時間がかかります。あとでもう一度ステータスを確認してください。対象となる画像が何時間経っても SUCCESS に達しない場合は、Databricks サポートにお問い合わせください。ステータスの定義については、画像アクセラレーションのステータスの確認を参照してください。
サポートを求める
ヘルプをリクエストする際は、以下の情報を含めてください。
- クラウド、リージョン、ワークスペースURL、およびDatabricks CLIのバージョン。
- 失敗したコマンドとその完全なエラーメッセージ。
- レジストリのホスト名と
catalog.schema.artifact:tagの名前。 - The image digest, API request ID, and operation timestamp, if available.
この情報は、プライベートサポートチャンネルのみを通じて共有してください。ワークスペースURL、レジストリホスト名、アーティファクト名、または完全なエラーを公開フォーラムに投稿しないでください。
共有する前に、エラー メッセージ、コマンド出力、およびその他の診断からトークン、パスワード、およびレジストリの資格情報を削除してください。