Importações em Bicep
Este artigo descreve a sintaxe que você usa para exportar e importar a funcionalidade compartilhada, bem como namespaces para provedores de extensibilidade do Bicep.
Exportando tipos, variáveis e funções (Visualização)
Nota
A CLI do Bíceps versão 0.23.X ou superior é necessária para usar esse recurso. O recurso compileTimeImports
experimental deve ser ativado a partir do arquivo de configuração do Bicep. Para funções definidas pelo usuário, o recurso userDefinedFunctions
experimental também deve ser habilitado.
O @export()
decorador é usado para indicar que uma determinada declaração pode ser importada por outro arquivo. Este decorador só é válido em instruções de tipo, variável e função. As instruções de variáveis marcadas com @export()
devem ser constantes de tempo de compilação.
A sintaxe para exportar a funcionalidade para uso em outros arquivos Bicep é:
@export()
<statement_to_export>
Importar tipos, variáveis e funções (Pré-visualização)
Nota
A CLI do Bíceps versão 0.23.X ou superior é necessária para usar esse recurso. O recurso compileTimeImports
experimental deve ser ativado a partir do arquivo de configuração do Bicep. Para funções definidas pelo usuário, o recurso userDefinedFunctions
experimental também deve ser habilitado.
A sintaxe para importar a funcionalidade de outro arquivo Bicep é:
import {<symbol_name>, <symbol_name>, ...} from '<bicep_file_name>'
Com aliasing opcional para renomear símbolos:
import {<symbol_name> as <alias_name>, ...} from '<bicep_file_name>'
Usando a sintaxe de importação curinga:
import * as <alias_name> from '<bicep_file_name>'
Você pode misturar e combinar as sintaxes anteriores. Para acessar símbolos importados usando a sintaxe curinga, você deve usar o .
operador: <alias_name>.<exported_symbol>
.
Somente as instruções que foram exportadas no arquivo que está sendo referenciado estão disponíveis para serem importadas .
A funcionalidade que foi importada de outro arquivo pode ser usada sem restrições. Por exemplo, as variáveis importadas podem ser usadas em qualquer lugar onde uma variável declarada no arquivo normalmente seria válida.
Exemplo
exportações.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
Importar namespaces e provedores de extensibilidade (Visualização)
Nota
O recurso experimental deve ser habilitado a partir do arquivo de configuração do Bicep para usar esse recursoextensibility
.
A sintaxe para importar namespaces é:
import 'az@1.0.0'
import 'sys@1.0.0'
Ambos az
e sys
são namespaces internos do Bicep. Eles são importados por padrão. Para obter mais informações sobre os tipos de dados e as funções definidas em az
e , consulte Tipos de dados e sys
funções do Bíceps.
A sintaxe para importar provedores de extensibilidade do Bicep é:
import '<provider-name>@<provider-version>'
A sintaxe para importar provedores de extensibilidade do Bicep que exigem configuração é:
import '<provider-name>@<provider-version>' with {
<provider-properties>
}
Para obter um exemplo, consulte Provedor Kubernetes de extensibilidade do Bicep.
Próximos passos
- Para saber mais sobre os tipos de dados Bicep, consulte Tipos de dados.
- Para saber mais sobre as funções do bíceps, consulte Funções do bíceps.
- Para saber mais sobre como usar o provedor Kubernetes, consulte Provedor Kubernetes de extensibilidade do Bicep.
- Para passar por um tutorial do provedor Kubernetes, consulte Guia de início rápido - Implantar aplicativos do Azure nos Serviços Kubernetes do Azure usando o provedor Kubernetes Bicep..