"noneステートメントの使用方法と使い方"

usingまたはusing none宣言は、すべての Bicep パラメーター ファイルに存在する必要があります。

通常、Bicep パラメーター ファイルでは、 using ステートメントを使用して、 ファイルを Bicep ファイル、 JSON Azure Resource Manager テンプレート (ARM テンプレート)、 Bicep モジュール、または テンプレート スペックに関連付けます。このリンケージにより、Bicep 言語サーバーとコンパイラは、テンプレートの入力に基づいて、正しい名前、型、および必要な値のパラメーター ファイル チェックを検証できます。

これに対し、 using none ステートメントは、コンパイル時にパラメーター ファイルが特定のテンプレートに関連付けられていないことを明示的に示します。 つまり、パラメーターは特定のテンプレートに対して検証されず、代わりに、外部ツールで使用されたり、共有の再利用可能なパラメーター セットとして機能したりするなど、より一般的な使用を目的としています。

using ステートメント

using ステートメントの構文:

• Bicep ファイルを使用するには:

  using '<path>/<file-name>.bicep'
  

• JSON ARM テンプレートを使用するには:

  using '<path>/<file-name>.json'
  

• パブリック モジュールを使用するには:

  using 'br/public:<file-path>:<tag>'
  

  次に例を示します。

  using 'br/public:avm/res/storage/storage-account:0.9.0' 
  
  param name = 'mystorage'
  

• プライベート モジュールを使用するには:

  using 'br:<acr-name>.azurecr.io/bicep/<file-path>:<tag>'
  

  次に例を示します。

  using 'br:myacr.azurecr.io/bicep/modules/storage:v1'
  

  bicepconfig.json ファイルで定義された別名でプライベート モジュールを使用するには:

  using 'br/<alias>:<file>:<tag>'
  

  次に例を示します。

  using 'br/storageModule:storage:v1'
  

• テンプレート スペックを使用するには:

  using 'ts:<subscription-id>/<resource-group-name>/<template-spec-name>:<tag>
  

  次に例を示します。

  using 'ts:00000000-0000-0000-0000-000000000000/myResourceGroup/storageSpec:1.0'
  

  bicepconfig.json ファイルで定義された別名でテンプレート スペックを使用するには:

  using 'ts/<alias>:<template-spec-name>:<tag>'
  

  次に例を示します。

  using 'ts/myStorage:storageSpec:1.0'
  

なしを使用するステートメント

Bicep パラメーター ファイル (.bicepparam) の using none ステートメントは、作成中またはコンパイル中にファイルが特定の Bicep テンプレートに関連付けられていないことを示します。 これにより、パラメーター ファイルが特定のテンプレートから切り離され、デプロイ間でのパラメーターの定義と使用の柔軟性が向上します。

using none ステートメントの構文:

using none

このステートメントは、特定のテンプレートが参照されていないことを通知するために、Bicep パラメーター ファイルの先頭に配置されます。

Bicep の using none の主な利点は、パラメーター ファイルが一般化、共有、またはテンプレートと動的に統合されるシナリオにあります。 一般的なユース ケースは次のとおりです。

• 一元化されたパラメーター リポジトリ

  多くの場合、組織は、既定のリージョン、名前付け規則、複数の Bicep デプロイで使用されるグローバル タグなどの標準パラメーター値を維持します。 何も使用しない Bicep パラメーター ファイルは、これらの共有値の中央ストアとして機能し、一貫性を向上させ、重複を最小限に抑えることができます。 これらのパラメーターは、デプロイ時にプログラムによってテンプレート固有の値とマージできます。

  たとえば、共有 Bicep パラメーター ファイルで次の定義が行われる場合があります。

  using none
  
  param location = 'westus2'
  param environmentTag = 'production'
  param projectName = 'myApp'
  

• 動的生成とランタイム統合

  CI/CD パイプラインまたはオートメーション スクリプトでは、パラメーター ファイルをその場で作成したり、実行時にテンプレートに関連付けたりすることができます。 固定テンプレート参照を省略することで、 using none これらのファイルを柔軟に保ち、さまざまなデプロイ コンテキストに適応できます。

Bicep パラメーター ファイルで using none が指定されている場合、コンパイラは特定の Bicep テンプレートに対してパラメーターを検証しません。つまり、リンクされたテンプレートがないため、名前または型の不一致に対してコンパイル時の警告やエラーが発生することはありません。 ただし、この切り離しは、デプロイ時の作成とコンパイル時にのみ適用されます。Azure Resource Manager (ARM) には Bicep テンプレートとパラメーター ファイルの両方が必要です。 ARM エンジンは、ターゲット テンプレートで定義されているパラメーターに対してファイル内のパラメーターを解決することで、デプロイ中に検証を実行します。

次のステップ

• 「Bicep デプロイ用のパラメーター ファイルを作成する」で Bicep パラメーター ファイルについて確認します。
• bicepconfig.json ファイルで別名を構成する方法を「Bicep 環境を構成する」で確認します。