「Oracle Cloudへのデプロイ」ボタンの使用

「Oracle Cloudにデプロイ」ボタンを使用して、リモートTerraform構成を起動します。

このページでは、「Oracle Cloudにデプロイ」ボタンのURLの作成に関する高度なトピックについて説明します。

適切にリンクされている場合、このボタンは、ユーザーがTerraform構成でスタックを作成するための直接オプションを提供します。

このボタンを使用すると、ユーザーはOracle Cloud Infrastructure Consoleの「スタックの作成」ページに直接移動します。このボタンは、指定したTerraform構成ファイル・パッケージにリンクされているため、ユーザーがスタックを作成したときに、Terraform構成がすでに選択されています。Terraform構成ファイルは、サポートされているプロバイダに格納できます。

「デプロイ」ボタンの機能の例

ヒント

OCI Terraform構成の例を使用して、スタックをすばやく作成します。Terraform Oracle Cloud Infrastructure Provider Examplesに移動し、必要な構成のフォルダ(admなど)に移動し、readmeの「マジック・ボタン」の下の「Oracle Cloudにデプロイ」ボタンを選択します。

次の「Oracle Cloudにデプロイ」ボタンは、https://github.com/oracle-quickstart/oci-cloudnativeからテンプレートを起動するように構成されています。

サポートされるプロバイダ

「Oracle Cloudにデプロイ」ボタンで使用するパッケージURLの形成では、次のプロバイダがサポートされています。

GitHub
例URL 1: Direct: https://github.com/myrepo/mydirectory/master.zip
例URL 2: リリース: https://github.com/myrepo/mydirectory/0.0.1.zip
zip URLをGitHubのリリースに取得するには、https://docs.github.com/en/free-pro-team@latest/github/administering-a-repository/linking-to-releasesを参照してください。
GitLab
例URL 1: Direct: https://gitlab.com/myrepo/mydirectory/master.zip
例URL 2: リリース: https://gitlab.com/myrepo/mydirectory/0.0.1.zip
オブジェクト・ストレージ(事前認証済リクエストのURL)
URLの例: https://objectstorage.region.oraclecloud.com/p/encrypted-string/n/object-storage-namespace/b/bucket/o/filename

エラー・コードをトラブルシューティングするには、「デプロイ・ボタンのエラー・コード400」を参照してください。

リンクされた配置ボタンを表示するには

重要

Terraform構成ファイルが有効であることを確認してください。構成の作成およびリソース・マネージャのTerraform構成を参照してください。

リンクされた「Oracle Cloudにデプロイ」ボタンは、リポジトリ・ページやその他のWebページに表示できます。

値下げコード

リポジトリ・ページに「Oracle Cloudにデプロイ」ボタンを表示するには、README.mdファイルに次のMarkdownコードを追加します。

[
![Deploy to Oracle Cloud]
(https://oci-resourcemanager-plugin.plugins.oci.oraclecloud.com/latest/deploy-to-oracle-cloud.svg)
]
(https://cloud.oracle.com/resourcemanager/stacks/create
?zipUrl=<package-url>)

<package-url>は、サポートされているプロバイダに格納されているTerraform構成への.zipファイルのURLです。

GitHubからのパッケージURLを使用したMarkdownコードの例:

[![Deploy to Oracle Cloud](https://oci-resourcemanager-plugin.plugins.oci.oraclecloud.com/latest/deploy-to-oracle-cloud.svg)](https://cloud.oracle.com/resourcemanager/stacks/create?zipUrl=https://github.com/myrepo/mydirectory/master.zip)

HTMLコード

Webページに「Oracle Cloudにデプロイ」ボタンを表示するには、次のHTMLコードを追加します。

<a 
href="https://cloud.oracle.com/resourcemanager/stacks/create?zipUrl=<package-url>" 
target="_blank">
  <img 
src="https://oci-resourcemanager-plugin.plugins.oci.oraclecloud.com/latest/deploy-to-oracle-cloud.svg" 
alt="Deploy to Oracle Cloud"/>
</a>

<package-url>は、サポートされているプロバイダに格納されているTerraform構成への.zipファイルのURLです。

GitHubからのパッケージURLを含むHTMLコードの例:

<a href="https://cloud.oracle.com/resourcemanager/stacks/create?zipUrl=https://github.com/myrepo/mydirectory/master.zip" target="_blank">
  <img src="https://oci-resourcemanager-plugin.plugins.oci.oraclecloud.com/latest/deploy-to-oracle-cloud.svg" alt="Deploy to Oracle Cloud"/>
</a>

リンクされたデプロイ・ボタンからスタックを作成するには

「Oracle Cloudへのデプロイ」を選択します(Terraform構成にリンクされた「デプロイ」ボタン)。

エラー・コードをトラブルシューティングするには、「デプロイ・ボタンのエラー・コード400」を参照してください。
Oracle Cloud Infrastructure Consoleにまだサインインしていない場合は、サインインします。最初のサインインを参照してください。

スタックの作成ページが表示され、選択したパッケージが識別されます。
新しいスタックの名前を入力します(または、表示されたデフォルトの名前を受け入れます)。機密情報を入力しないでください。
必要に応じて説明も入力します。
別のコンパートメントのリソースを表示するには、「コンパートメント」フィルタを使用してコンパートメントを切り替えます。

コンパートメント内のリソースを表示するには、そのコンパートメントで作業する権限が必要です。使用するコンパートメントが不明な場合は、管理者に問い合せてください。詳細は、コンパートメントの理解を参照してください。
「Terraformのバージョン」で、新しいスタックに使用するバージョンを選択します。

ノート

Terraformバージョンには下位互換性がありません。
オプション: 「タグ」で、スタックに1つ以上のタグを追加します。
リソースの作成権限がある場合は、フリーフォーム・タグをそのリソースに適用する権限もあります。定義済タグを適用するには、タグ・ネームスペースを使用する権限が必要です。タグ付けの詳細は、リソース・タグを参照してください。タグを適用するかどうかがわからない場合は、このオプションをスキップするか、管理者に問い合せてください。タグは後で適用できます。
「次」を選択します。

「変数の構成」パネルに、選択したTerraform構成ファイルの変数が表示されます。
変数を確認し、必要に応じて変更します。

重要

秘密キーやその他の機密情報は、構成変数に追加しないでください。
「次」を選択します。
「確認」パネルで、スタック構成を確認します。

デフォルトでは、「適用の実行」が選択されています。スタックの作成時にリソースを自動的にプロビジョニングするには、この設定を保持します。
「作成」を選択してスタックを作成します。

新しいスタックの詳細ページが表示されます。

「適用の実行」を選択した場合、リソース・マネージャは新しいスタックで適用アクションを実行します。

定義されたリソースをデプロイするには(「スタックの作成」ページで「適用の実行」を選択しなかった場合)、新しいスタックで適用ジョブを実行します。

Oracle Cloud Infrastructureドキュメント