1. Oracle Cloud Stackの使用
  2. Oracle Cloud Stackを使用したテンプレートの作成
  3. テンプレート・ファイルの編集
  4. 検証の使用
機械翻訳について

検証の使用

Oracle Cloud Stackテンプレート・ファイルを編集し、高度な検証基準を構成します。
テンプレートからスタックが作成されると、テンプレートに定義されている検証が実行され、テンプレート内のリソースがプロビジョニングされます。 検証が成功すると、Oracle Cloud Stackはリソースの作成を試みます。 失敗した検証はすべてユーザーに報告され、スタックは作成されません。

トピック

基本的な構文

テンプレート・ファイルのvalidationsノード内でテンプレートの検証を定義します。 検証ごとに、validationTypeを指定し、parametersノードを追加します。 

validations:
  myFirstValidation:
    validationType: DB_CONNECT
    parameters:
      ...
  mySecondValidation:
    validationType: STORAGE_CONNECT
    parameters:
      ...

使用可能なパラメータは、検証のタイプによって異なります。 これらの検証パラメータに静的な値を割り当てたり、GetParam関数を使用してテンプレート・パラメータの値を割り当てることができます。

オプションで、既存の条件の名前を割り当てることができます。 指定された条件がtrueと評価されない限り、検証は実行されません。 

validations:
  myValidation:
    condition: connectToDB
    validationType: DB_CONNECT
    parameters:
      ...

データベース接続

スタックを作成する前に、既存のOracle Database Cloud Serviceデプロイメントへの接続性を確認してください。 検証デプロイメントのデータベース配置の接続の詳細を提供します。 例: 

dbConnectivityValidation:
  validationType: DB_CONNECT
  parameters:
    serviceName: MyDBInstance
    userName: SYS
    password: password
    requiredSize: 10GB
    constraintDescription: Failed to connect to the MyDBInstance database
パラメータ 説明

serviceName (Optional)

既存のOracle Database Cloud Serviceデプロイメントの名前を入力します。

serviceNameまたはconnectStringのいずれかを指定する必要があります。

connectString (Optional)

既存のOracle Database Cloud Serviceデプロイメント用のJava Database Connectivity (JDBC)URLを入力します。 例えば : jdbc:oracle:thin:@203.0.113.100:1521:orcl。

serviceNameまたはconnectStringのいずれかを指定する必要があります。

userName

接続先のデータベース・ユーザー

password

データベース・ユーザーのパスワード

requiredSize (Optional)

データベースの使用可能な容量がこのサイズより小さい場合、検証は失敗します。

pdbName (Optional)

指定されたプラガブル・データベース(PDB)がデータベースに存在しない場合、検証は失敗します。

schemaName (Optional)

指定されたスキーマがすでにデータベースに存在する場合、検証は失敗します。

constraintDescription (Optional)

この検証が失敗した場合にユーザーに表示するエラー・メッセージ

ストレージの接続性

Oracle Cloud at CustomerではなくこのトピックはOracle Cloud at Customerには適用されません。

スタックを作成する前に、Oracle Cloud Infrastructure Container Service Classicへの接続性を確認してください。 検証定義にストレージ接続の詳細を提供します。

以下の例に示すように、ユーザー名とパスワードを使用してクラウド・ストレージに接続できます:

storageConnectivityValidation:
  validationType: STORAGE_CONNECT
  parameters:
    cloudStorageContainer: https://foo.storage.oraclecloud.com/v1/MyService-bar/MyContainer
    cloudStorageUser: john@example.com
    cloudStoragePassword: your_password
    checkIfContainerExists: false
    constraintDescription: Failed to connect to cloud storage as john

ストレージ資格証明を提供しない場合、Oracle Cloud StackはOAuthプロトコルを使用してクラウド・ストレージに接続しようとします。 オプションで、クラウド・ストレージへのOAuth認証用に事前に構成されたOracle Cloudサービスの名前を指定できます。 例: 

storageConnectivityValidation:
  validationType: STORAGE_CONNECT
  parameters:
    cloudStorageContainer: https://foo.storage.oraclecloud.com/v1/MyService-bar/MyContainer
    serviceType: jaas
    checkIfContainerExists: false
    constraintDescription: Failed to connect to cloud storage using jaas OAuth configuration

または、OAuthプロトコルを使用してクラウド・ストレージへの認証用に事前に構成されたOracle Cloud資格IDを指定することもできます。 例: 

storageConnectivityValidation:
  validationType: STORAGE_CONNECT
  parameters:
    cloudStorageContainer: https://foo.storage.oraclecloud.com/v1/MyService-bar/MyContainer
    serviceEntitlementId: 123456
    checkIfContainerExists: false
    constraintDescription: Failed to connect to cloud storage using entitlement 123456
パラメータ 説明

cloudStorageContainer

クラウド・ストレージ・コンテナのURL

checkIfContainerExistsがtrueの場合、この検証が成功するには、このコンテナがすでに存在していなければなりません。

cloudStorageUser (Optional)

接続するOracle Cloudユーザー

このパラメータに値を指定しないと、Oracle Cloud StackはOAuthプロトコルを使用してクラウド・ストレージに接続しようとします。

cloudStoragePassword (Optional)

指定されたクラウド・ユーザーのパスワード

このパラメータに値を指定しないと、Oracle Cloud StackはOAuthプロトコルを使用してクラウド・ストレージに接続しようとします。

checkIfContainerExists (Optional)

trueに設定すると、検証は指定されたストレージ・コンテナが存在する場合にのみ成功します。

falseに設定すると、検証によってストレージ・クラウド・サービスへの接続性が確認されます。

serviceType (Optional)

OAuthプロトコルを使用してクラウド・ストレージへの認証用に事前に構成されたOracle Cloudサービスの名前。 Oracle Cloud Stackは、このサービスのOAuth構成を使用して、クラウド・ストレージへの接続を検証します。 リソース・タイプのリストを参照してください。

指定しない場合、Oracle Cloud StackはOAuth用に構成されたサービスを自動的に選択します。

serviceEntitlementId (Optional)

OAuthプロトコルを使用してクラウド・ストレージへの認証用に事前に構成されたOracle Cloud資格ID。 Oracle Cloud StackはこのアカウントのOAuth構成を使用して、クラウド・ストレージへの接続を検証します。

指定しない場合、Oracle Cloud StackはOAuth用に構成されたアカウントを自動的に選択します。

serviceTypeとserviceEntitlementIdの両方が指定されている場合は、serviceEntitlementIdが優先されます。

constraintDescription (Optional)

この検証が失敗した場合にユーザーに表示するエラー・メッセージ

一般的な制約

Oracle Cloud at CustomerではなくこのトピックはOracle Cloud at Customerには適用されません。

標準テンプレート関数を使用する条件式を評価します。 式がfalseと評価された場合、検証は失敗します。 例: 

passwordValidation:
  validationType: CONSTRAINT
  parameters:
    constraint: {"Fn::Equals": [{"Fn::GetParam": "password"}, "oracle"]}
    constraintDescription: The password oracle is not permitted. Enter a different password.

条件式の詳細については、「条件の使用」と「関数一覧」を参照してください。

パラメータ 説明

constraint

trueまたはfalseのいずれかに評価されるYAML式。 式がfalseと評価された場合、検証は失敗します。

constraintDescription (Optional)

この検証が失敗した場合にユーザーに表示するエラー・メッセージ