Rozšíření Bicep Kubernetes (Preview)

Rozšíření Kubernetes umožňuje vytvářet prostředky Kubernetes přímo pomocí Bicep. Bicep může nasadit cokoli, co se dá nasadit pomocí klienta příkazového řádku Kubernetes (kubectl) a souboru manifestu Kubernetes.

Poznámka:

Rozšíření Kubernetes se v současné době nepodporuje pro privátní clustery:

resource AKS 'Microsoft.ContainerService/managedClusters@2024-02-01' = {
 ...
 properties: {
  apiServerAccessProfile: {
    enablePrivateCluster: true
  }
 }
}

Povolení funkce Preview

Tuto funkci Preview můžete povolit konfigurací bicepconfig.json:

{
  "experimentalFeaturesEnabled": {
    "extensibility": true
  }
}

Import rozšíření Kubernetes

Pokud chcete bezpečně předat tajné kódy pro nasazení Kubernetes, musíte kód Kubernetes vyvolat pomocí modulu Bicep a předat parametr jako tajný kód. K importu rozšíření Kubernetes použijte příkaz rozšíření. Po importu rozšíření můžete refaktorovat soubor modulu Bicep jako obvykle, například pomocí proměnných, parametrů a výstupu. Manifest Kubernetes ve smlouvě v YML neobsahuje žádnou podporu programovatelnosti.

Následující ukázka naimportuje rozšíření Kubernetes:

@secure()
param kubeConfig string

extension kubernetes with {
  namespace: 'default'
  kubeConfig: kubeConfig
} as k8s

• obor názvů: Zadejte obor názvů rozšíření.
• KubeConfig: Zadejte hodnotu s kódováním base64 přihlašovacích údajů správce clusteru Kubernetes.

Následující ukázka ukazuje, jak předat kubeConfig hodnotu z nadřazeného souboru Bicep:

resource aks 'Microsoft.ContainerService/managedClusters@2024-08-01' existing = {
  name: 'demoAKSCluster'
}

module kubernetes './kubernetes.bicep' = {
  name: 'buildbicep-deploy'
  params: {
    kubeConfig: aks.listClusterAdminCredential().kubeconfigs[0].value
  }
}

Cluster AKS může být nový prostředek nebo existující prostředek. Příkaz Import Kubernetes manifest z editoru Visual Studio Code může automaticky přidat fragment kódu importu. Podrobnosti najdete v tématu Import příkazu manifestu Kubernetes.

Import editoru Visual Studio Code

V editoru Visual Studio Code můžete importovat soubory manifestu Kubernetes a vytvářet soubory modulů Bicep. Další informace najdete v editoru Visual Studio Code.

Další kroky

• Pokud si chcete projít rychlý start, přečtěte si článek Rychlý start – Nasazení aplikací Azure do azure Kubernetes Services pomocí rozšíření Bicep Kubernetes.
• Další informace o používání rozšíření Microsoft Graph najdete v šablonách Bicep pro Microsoft Graph.