Oracle Cloud Infrastructureドキュメント

Oracle Cloud Infrastructure Registryへのログイン

OCIファンクションで使用するためにOracle Cloud Infrastructure Registryにログインする方法を確認します。

OCI Functionsを使用する前に、Dockerイメージとしてファンクションを格納するDockerレジストリにログインする必要があります。これは、Fn ProjectのCLIコンテキストで指定されているDockerレジストリです(Oracle Cloud Infrastructureに接続するためのFn ProjectのCLIコンテキストの作成を参照)。

Oracle Cloud Infrastructure Registryの公開リポジトリとプライベート・リポジトリにファンクションを格納できます。これはOracle Cloud Infrastructureの上に組み込まれている、Oracleが管理するレジストリです。

DockerでDockerレジストリにログインする場合、適切な認証詳細を指定する必要があります。たとえば、Oracle Cloud Infrastructure Registryの場合、テナンシ・オブジェクト・ストレージのネームスペース、ユーザー名およびユーザーの認証トークンを指定する必要があります。

開発環境としてCloud Shellを使用している場合は、「スタート・ガイド」ページから「クラウド・シェル」ウィンドウにコマンドをコピーして貼り付ける必要があります。詳細は、クラウド・シェルでのOCIファンクションQuickStartガイドを参照してください。

このトピックの手順では、次のことを前提としています:

  • クラウド・シェルを開発環境として使用していません
  • Linuxを使用している
  • Dockerの起動のステップをすでに完了しています

DockerでOracle Cloud Infrastructure Registryにログインするには:

  1. ファンクション開発者として開発環境にログインします。

  2. ターミナル・ウィンドウで、次のように入力してOracle Cloud Infrastructure Registryにログインします:

    docker login <region-key>.ocir.io

    <region-key>は、Fn ProjectのCLIコンテキストで指定されているOracle Cloud Infrastructure Registryリージョンのキーです(Oracle Cloud Infrastructureに接続するためのFn ProjectのCLIコンテキストの作成を参照)。たとえば、Phoenixの場合はphxです。リージョン別の可用性を参照してください。

    例:

    docker login phx.ocir.io

  3. ユーザー名を求められたら、OCIファンクションを使用してファンクションを作成およびデプロイするユーザー名を次の形式で入力します:

    <tenancy-namespace>/<username>

    <tenancy-namespace>は、リポジトリを作成するテナンシの自動生成されたオブジェクト・ストレージ・ネームスペース文字列(「テナンシ情報」ページに表示)です。たとえば、ansh81vru1zp/jdoe@acme.comです。

    一部の古いテナンシでは、ネームスペース文字列が、すべて小文字のテナンシ名(たとえば、acme-dev)と同じ場合があることに注意してください。

    テナンシがOracle Identity Cloud Serviceとフェデレートされている場合は、<tenancy-namespace>/oracleidentitycloudservice/<username>の書式を使用します。

    指定したユーザー用にOracle Cloud Infrastructure認証トークンがすでに生成されている必要があります(Oracle Cloud Infrastructure Registryへのログインを有効にする認証トークンの生成を参照)。

  4. パスワードの入力を求められたら、ユーザーのOracle Cloud Infrastructure認証トークンを入力します。パスワードが入力されると、Dockerにより、パスワードがDocker構成ファイルに暗号化されずに格納されていることが警告される場合があります。この警告には、資格証明ヘルパーの構成方法を見つけることができるDockerドキュメントへのリンクが含まれています。セキュリティを強化するために、Dockerドキュメントの情報を確認し、外部資格証明ストアの使用を検討することをお薦めします。

このトピックのステップを完了したら、クライアント環境の構成タスクは完了です。ファンクション開発の構成の検証に移動して、Fn ProjectのCLIがAPIエンドポイントと通信できることを確認します。