Provedor de Kubernetes de extensibilidade do Bicep (Versão Prévia)
O provedor Kubernetes permite que você crie recursos do Kubernetes diretamente com o Bicep. O Bicep pode implantar qualquer coisa que possa ser implantada com o cliente de linha de comando (kubectl) do Kubernetes e um arquivo de manifesto do Kubernetes.
Observação
No momento, o provedor Kubernetes não é compatível com clusters privados:
resource AKS 'Microsoft.ContainerService/managedClusters@2023-01-02-preview' = {
...
properties: {
apiServerAccessProfile: {
enablePrivateCluster: true
}
}
}
Habilitar a versão prévia do recurso
Essa versão prévia do recurso pode ser habilitada configurando o bicepconfig.json:
{
"experimentalFeaturesEnabled": {
"extensibility": true
}
}
Importar provedor do Kubernetes
Para passar segredos com segurança para a implantação do Kubernetes, você deve invocar o código Kubernetes com um módulo Bicep e passar o parâmetro como um segredo. Para importar o provedor Kubernetes, use a instrução import. Depois de importar o provedor, você pode refatorar o arquivo de módulo Bicep como de costume, como usando variáveis, parâmetros e saída. Por contrato, o manifesto do Kubernetes no YML não inclui nenhum suporte de programação.
O exemplo a seguir importa o provedor Kubernetes:
@secure()
param kubeConfig string
import 'kubernetes@1.0.0' with {
namespace: 'default'
kubeConfig: kubeConfig
} as k8s
- namespace: Especifique o namespace do provedor.
- KubeConfig: Especifique um valor codificado em base64 das credenciais de administrador de cluster do Kubernetes.
O exemplo a seguir mostra como passar o valor kubeConfig de um arquivo Bicep pai:
resource aks 'Microsoft.ContainerService/managedClusters@2022-05-02-preview' existing = {
name: 'demoAKSCluster'
}
module kubernetes './kubernetes.bicep' = {
name: 'buildbicep-deploy'
params: {
kubeConfig: aks.listClusterAdminCredential().kubeconfigs[0].value
}
}
O cluster do AKS pode ser um novo recurso ou um recurso existente. O comando Import Kubernetes manifest do Visual Studio Code pode adicionar automaticamente o trecho de código de importação. Para obter detalhes, consulte Importar comando de manifesto do Kubernetes.
importação Visual Studio Code
Do Visual Studio Code, você pode importar arquivos de manifesto do Kubernetes para criar arquivos de módulo do Bicep. Para obter mais informações, confira Visual Studio Code.