Udostępnij za pośrednictwem

Rozszerzenie Bicep Kubernetes (wersja zapoznawcza)

  • Artykuł

Rozszerzenie Kubernetes umożliwia bezpośrednie tworzenie zasobów Kubernetes za pomocą rozwiązania Bicep. Bicep może wdrożyć wszystko, co można wdrożyć za pomocą klienta wiersza polecenia Kubernetes (kubectl) i pliku manifestu Kubernetes.

Uwaga

Rozszerzenie Kubernetes nie jest obecnie obsługiwane w przypadku klastrów prywatnych:

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

Włączanie funkcji w wersji zapoznawczej

Tę funkcję w wersji zapoznawczej można włączyć, konfigurując bicepconfig.json:

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

Importowanie rozszerzenia Kubernetes

Aby bezpiecznie przekazywać wpisy tajne dla wdrożenia platformy Kubernetes, należy wywołać kod Kubernetes z modułem Bicep i przekazać parametr jako wpis tajny. Aby zaimportować rozszerzenie Kubernetes, użyj instrukcji import. Po zaimportowaniu rozszerzenia można refaktoryzować plik modułu Bicep w zwykły sposób, na przykład przy użyciu zmiennych, parametrów i danych wyjściowych. Zgodnie z umową manifest Kubernetes w języku YML nie obejmuje żadnej obsługi programowości.

Poniższy przykład importuje rozszerzenie Kubernetes:

@secure()
param kubeConfig string

import 'kubernetes@1.0.0' with {
  namespace: 'default'
  kubeConfig: kubeConfig
} as k8s
  • przestrzeń nazw: określ przestrzeń nazw rozszerzenia.
  • KubeConfig: określ zakodowaną w formacie base64 wartość poświadczeń administratora klastra Kubernetes.

W poniższym przykładzie pokazano, jak przekazać kubeConfig wartość z nadrzędnego pliku Bicep:

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

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

Klaster usługi AKS może być nowym zasobem lub istniejącym zasobem. Polecenie Import Kubernetes manifest z programu Visual Studio Code może automatycznie dodać fragment kodu importu. Aby uzyskać szczegółowe informacje, zobacz Importowanie polecenia manifestu kubernetes.

Importowanie programu Visual Studio Code

W programie Visual Studio Code możesz zaimportować pliki manifestu kubernetes, aby utworzyć pliki modułu Bicep. Aby uzyskać więcej informacji, zobacz Visual Studio Code.

Następne kroki