アーティファクトレジスタのトラブルシューティング

Important

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

Note

DatabricksはArtifact Registryが一般に利用可能になった際に価格を発表します。

このページを使って、Artifact Registryに関するよくある問題を解決してください。 完全なセットアップおよびイメージプッシュのワークフローについては、「 Art Registerで始めましょう」をご覧ください。

プレビューアクセスの問題

アーティファクトレジストリは有効になっていません

ワークスペース管理者に、ワークスペースプレビューページでDatabricksアーティファクトレジストリを有効にするよう依頼してください。 プレビューが利用できない場合は、ワークスペースがArtifact Registryに対応しているリージョンにあるか確認してください。 制限事項を参照してください。

プレビューのステータスは一時的に利用できません

操作を再試行してください。 エラーが続く場合は、エラーの詳細を収集し、助けを求める際にIDがあればリクエストしてください。

Dockerの認証問題

Docker認証コマンドは利用できません

DatabricksのCLI(コマンドライン インターフェイス)をRequirementsに記載されている最小サポート バージョンにインストールまたは更新してから、databricks auth docker configureを再度実行してください。

Dockerはレジストリ認証情報を取得できません

ワークスペースのOAuthプロファイルを作成または更新し、ワークスペースレジストリ用のDockerを設定し、Docker操作を再度試行します。 次のコマンドを実行してください:

databricks auth login --profile <profile>
databricks auth docker configure --profile <profile>

<profile>が意図した作業スペースを指しているか確認してください。 デフォルトのプロファイルを使う場合は、Docker認証コマンドから --profile <profile> を省略してください。

Dockerの認証ヘルパーは、個人アクセストークン、OAuthマシン間(M2M)認証情報、またはアカウントのみ認証を使用するプロファイルをサポートしていません。 認証の全手順については、「 Docker authenticationの設定」をご覧ください。

長期間実行されるプッシュは認可エラーを返します

Dockerの認証ヘルパーは、短命なワークスペースOAuthアクセストークンを提供します。 長期間実行中のプッシュで認証エラーが返された場合、 docker push 再試行して資格ヘルパーが新しいトークンを要求します。 資格の生涯については 「制限」を参照してください。

レジストリのホスト名が一致しません

databricks auth docker host --profile <profile>を実行して、選択したプロファイルのレジストリホスト名とDockerの認証情報ヘルパーの状態を確認してください。 プロファイルが意図したワークスペースを指しているか確認してください。 プッシュを再挑戦する前に、正しい レジストリホスト名 でイメージにタグを付け直してください。

イメージプッシュの問題

プッシュは許可エラーを返します

プッシュ操作に必要な権限をプリンシパルに持っているか確認してください。 「 許可の付与」を参照してください。

画像名は却下されます

<registry-hostname>/<catalog>.<schema>.<artifact>:<tag> という形式を使用します。 アーティファクトセグメントの要件については、 アーティファクト名の要件を参照してください。

カタログやスキーマは存在しません

アーティファクト・レジストリはカタログやスキーマを作成しません。 ターゲットのカタログとスキーマはすでにUnity Catalogに存在し、ワークスペースからアクセス可能でなければなりません。 不足しているオブジェクトを作成するか、既存のカタログとスキーマを使い、プッシュを再挑戦する前に必要な権限を確認してください。

画像発見の問題

画像やバージョンは表示されません

Dockerのプッシュが正常に完了し、プッシュしたカタログ、スキーマ、アーティファクト名が同じであることを確認しましょう。 アーティファクトやバージョンを一覧表示するには、レジストリエンドポイントではなくソフトウェアアーティファクトAPIを使用してください。 イメージとバージョンの確認をご覧ください。

レジストリ操作はサポートされていません

レジストリエンドポイントはこの操作をサポートしていません。 ソフトウェアアーティファクトAPIを使って画像やバージョンを発見してください。 制限については 「制限」を参照してください。

画像加速の問題

画像加速は依然として存在します UNSPECIFIED

UNSPECIFIED 故障を特定できません。 画像加速度の適格性に関する 制限 (画像サイズ制限を含む)を参照してください。 対象画像が大きいほど変換に時間がかかります。 後で状況を確認してください。 対象画像が数時間経っても SUCCESS に届かない場合は、 Databricksサポートにご連絡ください。 ステータス定義については「 画像加速ステータスの確認」を参照してください。

助けを求めてください

助けを求める際は、以下の情報を添付してください:

  • クラウド、リージョン、ワークスペースのURL、そしてDatabricksのCLIバージョンです。
  • 失敗したコマンドとその完全なエラーメッセージ。
  • レジストリのホスト名と catalog.schema.artifact:tag 名です。
  • 画像ダイジェスト、APIリクエストID、そして利用可能な場合は操作タイムスタンプ。

この情報はプライベートのサポートチャネルでのみ共有してください。 ワークスペースのURLやレジストリホスト名、アーティファクト名、または完全な誤りを公開フォーラムに投稿しないでください。

共有する前に、エラーメッセージやコマンド出力、その他の診断からトークン、パスワード、レジストリ認証情報を削除してください。