Importálás a Bicepben

Ez a cikk a megosztott funkciók exportálásához és importálásához használt szintaxist, valamint a Bicep bővíthetőségi szolgáltatók névtereit ismerteti.

Típusok, változók és függvények exportálása (előzetes verzió)

Megjegyzés:

A funkció használatához a Bicep CLI 0.23.X vagy újabb verziója szükséges. A kísérleti funkciót compileTimeImports engedélyezni kell a Bicep konfigurációs fájlból. Felhasználó által definiált függvények esetében a kísérleti funkciót userDefinedFunctions is engedélyezni kell.

A @export() dekorátor azt jelzi, hogy egy adott utasítást egy másik fájl importálhat. Ez a dekorátor csak típus-, változó- és függvénymegjelenítőkre érvényes. A változó utasításoknak fordítási időállandóknak @export() kell lenniük.

A más Bicep-fájlokban használható funkciók exportálásának szintaxisa a következő:

@export()
<statement_to_export>

Típusok, változók és függvények importálása (előzetes verzió)

Megjegyzés:

A funkció használatához a Bicep CLI 0.23.X vagy újabb verziója szükséges. A kísérleti funkciót compileTimeImports engedélyezni kell a Bicep konfigurációs fájlból. Felhasználó által definiált függvények esetében a kísérleti funkciót userDefinedFunctions is engedélyezni kell.

A funkciók másik Bicep-fájlból való importálásának szintaxisa a következő:

import {<symbol_name>, <symbol_name>, ...} from '<bicep_file_name>'

A szimbólumok átnevezéséhez választható aliasolással:

import {<symbol_name> as <alias_name>, ...} from '<bicep_file_name>'

A helyettesítő karakterek importálási szintaxisának használata:

import * as <alias_name> from '<bicep_file_name>'

Az előző szintaxisokat kombinálhatja és egyeztetheti. Ha az importált szimbólumokat helyettesítő karakterek szintaxisával szeretné elérni, a következő operátort . kell használnia: <alias_name>.<exported_symbol>.

Csak a hivatkozott fájlban exportált utasítások importálhatók.

A másik fájlból importált funkciók korlátozás nélkül használhatók. Az importált változók például bárhol használhatók, ahol egy fájlban deklarált változó általában érvényes lenne.

Példa

export.bicep

@export()
type myObjectType = {
  foo: string
  bar: int
}

@export()
var myConstant = 'This is a constant value'

@export()
func sayHello(name string) string => 'Hello ${name}!'

main.bicep

import * as myImports from 'exports.bicep'
import {myObjectType, sayHello} from 'exports.bicep'

param exampleObject myObjectType = {
  foo: myImports.myConstant
  bar: 0
}

output greeting string = sayHello('Bicep user')
output exampleObject myImports.myObjectType = exampleObject

Névterek és bővíthetőségi szolgáltatók importálása (előzetes verzió)

Megjegyzés:

A funkció használatához engedélyezni kell a kísérleti funkciót extensibility a Bicep konfigurációs fájlból .

A névterek importálásának szintaxisa a következő:

import 'az@1.0.0'
import 'sys@1.0.0'

Mindkettő az , és sys a Bicep beépített névterei. A rendszer alapértelmezés szerint importálja őket. Az adattípusokról és a benne definiált azsysfüggvényekről további információt az Adattípusok és a Bicep-függvények című témakörben talál.

A Bicep bővíthetőségi szolgáltatók importálásának szintaxisa a következő:

import '<provider-name>@<provider-version>'

A konfigurálást igénylő Bicep bővíthetőségi szolgáltatók importálásának szintaxisa a következő:

import '<provider-name>@<provider-version>' with {
  <provider-properties>
}

Példa: Bicep bővíthetőségi Kubernetes-szolgáltató.

További lépések

• A Bicep-adattípusokról további információt az Adattípusok című témakörben talál.
• A Bicep-függvényekről további információt a Bicep-függvények című témakörben talál.
• A Kubernetes-szolgáltató használatáról a Bicep bővíthetőségi Kubernetes-szolgáltató című témakörben olvashat.
• A Kubernetes-szolgáltatói oktatóanyagot a Rövid útmutató – Azure-alkalmazások üzembe helyezése az Azure Kubernetes Servicesben a Bicep Kubernetes-szolgáltató használatával című témakörben tekintheti meg.