アーティファクト・レジストリのトラブルシューティング
ベータ版
この機能は ベータ版です。使用するには、ワークスペース管理者が [プレビュー] ページから Databricks Artifact Registry を有効にする必要があります。Databricks のプレビューを管理するを参照してください。Databricks は、アーティファクトレジストリが一般提供されるようになったときに価格を発表します。
このページを使用して、アーティファクトレジストリに関する一般的な問題を解決します。完全なセットアップおよびイメージプッシュのワークフローについては、「アーティファクトレジストリの使用開始」を参照してください。
ベータ版アクセスに関する問題
アーティファクトレジストリが有効になっていません
ワークスペース管理者に依頼して、ワークスペースの [ プレビュー ] ページで Databricks Artifact Registry を有効にしてもらってください。プレビューを利用できない場合は、ワークスペースがアーティファクト レジストリをサポートしているリージョンにあることを確認してください。制限事項を参照してください。
プレビューのステータスを一時的に取得できません
操作を再試行してください。エラーが解決しない場合は、サポートをリクエストする際にエラーの詳細と、存在する場合はリクエスト ID を収集してください。
Dockerの認証に関する問題
Dockerの認証コマンドを使用できません
Databricks CLI (コマンドラインインターフェース) を 要件に記載されている最低サポートバージョン以上にインストールまたはアップデートしてから、 databricks auth docker configureを再ランしてください。
Dockerでレジストリの資格情報を取得できません
ワークスペースの OAuth プロファイルの作成または更新、ワークスペース レジストリ用の Docker の構成を行い、Docker 操作を再試行します。次のコマンドを実行します。
databricks auth login --profile <profile>
databricks auth docker configure --profile <profile>
<profile>が目的のワークスペースを指していることを確認します。default プロファイルを使用する場合は、Docker 認証コマンドから --profile <profile> を省略します。
Dockerの認証情報ヘルパーは、パーソナルアクセストークン、OAuthマシン間 (M2M) 認証情報、またはアカウントのみの認証を使用するプロファイルをサポートしていません。認証の完全な手順については、Docker認証のセットアップを参照してください。
長時間実行されるプッシュで認証エラーが返されます
Docker認証情報ヘルパーは、有効期間の短いワークスペースのOAuthアクセストークンを提供します。長時間実行されるプッシュによって認可エラーが返された場合は、認証情報ヘルパーが新しいトークンを要求するようにdocker pushを再試行してください。認証情報の有効期間については、制限事項をご覧ください。
レジストリのホスト名が一致しません
databricks auth docker host --profile <profile> を実行して、選択したプロファイルのレジストリホスト名と Docker 資格情報ヘルパーの状態を確認します。プロファイルが目的のワークスペースを指していることを確認します。プッシュを再試行する前に、イメージのタグを正しい レジストリホスト名 に付け直してください。
イメージプッシュの問題
プッシュで権限エラーが返される
プッシュ操作に必要な権限をプリンシパルが持っていることを確認します。権限の付与を参照してください。
画像名が却下されました
<registry-hostname>/<catalog>.<schema>.<artifact>:<tag>形式を使用します。アーティファクトセグメントの要件については、アーティファクト名の要件を参照してください。
カタログまたはスキーマが存在しません
アーティファクトレジストリは、カタログやスキーマを作成しません。ターゲットのカタログとスキーマがUnity Catalogにすでに存在し、ワークスペースからアクセス可能である必要があります。存在しないオブジェクトを作成するか、既存のカタログとスキーマを使用し、プッシュを再試行する前に必要な権限を確認してください。
画像ディスカバリーに関する問題
画像またはバージョンが表示されません
Dockerのプッシュが正常に完了したこと、およびプッシュしたものと同じカタログ、スキーマ、アーティファクト名を一覧表示していることを確認してください。アーティファクトとバージョンを一覧表示するには、レジストリのエンドポイントではなくSoftware Artifacts APIを使用してください。イメージとバージョンの検出を参照してください。
レジストリ操作はサポートされていません
レジストリエンドポイントはこの操作をサポートしていません。Software Artifacts API を使用して、画像とバージョンを検索します。制限事項については、制限事項を参照してください。
画像高速化の問題
画像高速化が右の状態のまま UNSPECIFIED
UNSPECIFIED は失敗を識別しません。画像サイズの制限など、画像アクセラレーションの対象となる条件については、制限事項を参照してください。対象となる大きい画像ほど、変換に時間がかかります。あとでもう一度ステータスを確認してください。対象となる画像が何時間経っても SUCCESS に達しない場合は、Databricks サポートにお問い合わせください。ステータスの定義については、画像アクセラレーションのステータスの確認を参照してください。
サポートを求める
ヘルプをリクエストする際は、以下の情報を含めてください。
- クラウド、リージョン、ワークスペースURL、およびDatabricks CLIのバージョン。
- 失敗したコマンドとその完全なエラーメッセージ。
- レジストリのホスト名と
catalog.schema.artifact:tagの名前。 - イメージのダイジェスト、APIリクエストID、および操作のタイムスタンプ (取得できる場合)。
この情報は、プライベートサポートチャンネルのみを通じて共有してください。ワークスペースURL、レジストリホスト名、アーティファクト名、または完全なエラーを公開フォーラムに投稿しないでください。
共有する前に、エラー メッセージ、コマンド出力、およびその他の診断からトークン、パスワード、およびレジストリの資格情報を削除してください。