Instalowanie rozszerzenia Dapr dla usługi Azure Kubernetes Service (AKS) i platformy Kubernetes z obsługą usługi Arc

Artykuł
08/02/2024

Język Dapr upraszcza tworzenie odpornych, bezstanowych i stanowych aplikacji uruchamianych w chmurze i brzegu oraz obejmuje różnorodność języków i struktur deweloperskich. Dzięki architekturze przyczepki dapr możesz zachować niezależną od platformy kodu, a jednocześnie sprostać wyzwaniom związanym z tworzeniem mikrousług, takich jak:

Niezawodne i bezpieczne wywoływanie innych usług
Tworzenie aplikacji opartych na zdarzeniach za pomocą pub/sub
Tworzenie aplikacji przenośnych między wieloma usługami i hostami w chmurze (na przykład Kubernetes a maszyną wirtualną)

Uwaga

Jeśli planujesz zainstalowanie języka Dapr w środowisku produkcyjnym Kubernetes, zapoznaj się ze stroną dokumentacji dotyczącej użycia produkcyjnego w języku Dapr.

Jak to działa

Rozszerzenie Dapr używa interfejsu wiersza polecenia platformy Azure lub szablonu Bicep do aprowizowania płaszczyzny sterowania dapr w klastrze AKS lub Kubernetes z obsługą usługi Arc, tworząc następujące usługi Dapr:

Usługa Dapr	opis
`dapr-operator`	Zarządza aktualizacjami składników i punktami końcowymi usług Kubernetes dla języka Dapr (magazyny stanów, pub/podsieci itp.)
`dapr-sidecar-injector`	Wprowadza język Dapr do zasobników wdrożenia z adnotacjami i dodaje zmienne `DAPR_HTTP_PORT` środowiskowe oraz `DAPR_GRPC_PORT` umożliwia aplikacjom zdefiniowanym przez użytkownika łatwe komunikowanie się z językiem Dapr bez kodowania wartości portów dapr.
`dapr-placement`	Używane tylko dla aktorów. Tworzy tabele mapowania mapujące wystąpienia aktora na zasobniki.
`dapr-sentry`	Zarządza usługami mTLS i działa jako urząd certyfikacji. Aby uzyskać więcej informacji, przeczytaj omówienie zabezpieczeń.

Po zainstalowaniu języka Dapr w klastrze możesz rozpocząć opracowywanie przy użyciu interfejsów API bloków konstrukcyjnych języka Dapr, dodając kilka adnotacji do wdrożeń. Aby uzyskać bardziej szczegółowe omówienie interfejsów API bloków konstrukcyjnych i sposobu ich najlepszego użycia, zobacz Omówienie bloków konstrukcyjnych języka Dapr.

Ostrzeżenie

Jeśli zainstalujesz język Dapr za pośrednictwem rozszerzenia Kubernetes z obsługą usługi AKS lub arc, zalecamy dalsze używanie rozszerzenia do przyszłego zarządzania usługą Dapr zamiast interfejsu wiersza polecenia języka Dapr. Połączenie tych dwóch narzędzi może powodować konflikty i powodować niepożądane zachowanie.

Wymagania wstępne

Subskrypcja platformy Azure. Nie masz go? Utwórz bezpłatne konto.
Najnowsza wersja interfejsu wiersza polecenia platformy Azure.
Istniejący klaster usługi AKS lub połączony klaster Kubernetes z obsługą usługi Arc.
Rola administratora kontroli dostępu opartej na rolach usługi Azure Kubernetes Service

Wybierz sposób instalowania, wdrażania i konfigurowania rozszerzenia Języka Dapr.

Interfejs wiersza polecenia platformy Azure
Bicep

Zanim rozpoczniesz

Dodawanie rozszerzenia interfejsu wiersza polecenia platformy Azure dla rozszerzeń klastra

Zainstaluj rozszerzenie interfejsu wiersza polecenia platformy k8s-extension Azure, uruchamiając następujące polecenia:

az extension add --name k8s-extension

k8s-extension Jeśli rozszerzenie jest już zainstalowane, możesz zaktualizować je do najnowszej wersji przy użyciu następującego polecenia:

az extension update --name k8s-extension

Rejestrowanie dostawcy `KubernetesConfiguration` zasobów

Jeśli jeszcze nie używasz rozszerzeń klastra, może być konieczne zarejestrowanie dostawcy zasobów w ramach subskrypcji. Stan rejestracji dostawcy można sprawdzić przy użyciu polecenia az provider list , jak pokazano w poniższym przykładzie:

az provider list --query "[?contains(namespace,'Microsoft.KubernetesConfiguration')]" -o table

Dostawca Microsoft.KubernetesConfiguration powinien zgłosić wartość Zarejestrowano, jak pokazano w następujących przykładowych danych wyjściowych:

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

Jeśli dostawca jest wyświetlany jako NotRegistered, zarejestruj dostawcę przy użyciu polecenia az provider register , jak pokazano w poniższym przykładzie:

az provider register --namespace Microsoft.KubernetesConfiguration

Rejestrowanie funkcji w subskrypcji platformy `ExtenstionTypes` Azure

Ta funkcja musi zostać zarejestrowana ExtensionTypes w ramach subskrypcji platformy Azure. W terminalu sprawdź, czy jesteś w odpowiedniej subskrypcji:

az account set --subscription <YOUR-AZURE-SUBSCRIPTION-ID>

ExtenstionTypes Zarejestruj funkcję.

az feature registration create --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

Rejestracja funkcji może zająć trochę czasu. Po kilku minutach sprawdź stan rejestracji przy użyciu następującego polecenia:

az feature show --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

Tworzenie rozszerzenia i instalowanie narzędzia Dapr w klastrze Kubernetes z obsługą usługi AKS lub arc

Podczas instalowania rozszerzenia Dapr użyj wartości flagi odpowiadającej typowi klastra:

Klaster AKS: --cluster-type managedClusters.
Klaster Kubernetes z obsługą usługi Arc: --cluster-type connectedClusters.

Uwaga

Jeśli używasz systemu operacyjnego Dapr w klastrze usługi AKS i chcesz zainstalować rozszerzenie Dapr dla usługi AKS, przeczytaj więcej o tym, jak pomyślnie przeprowadzić migrację do rozszerzenia Dapr.

Utwórz rozszerzenie Dapr, które instaluje środowisko Dapr w klastrze Kubernetes z obsługą usługi AKS lub arc.

Na przykład zainstaluj najnowszą wersję języka Dapr za pośrednictwem rozszerzenia Dapr w klastrze usługi AKS:

az k8s-extension create --cluster-type managedClusters \
--cluster-name <myAKSCluster> \
--resource-group <myResourceGroup> \
--name dapr \
--extension-type Microsoft.Dapr \
--auto-upgrade-minor-version false

Aktualizowanie zarządzanego klastra usługi AKS do najnowszej wersji

Na podstawie środowiska (deweloperskiego, testowego lub produkcyjnego) możesz być na bieżąco z najnowszymi stabilnymi wersjami języka Dapr.

Wybieranie pociągu wydania

Podczas konfigurowania rozszerzenia możesz zainstalować środowisko Dapr z określonego szkolenia wydania. Określ jedną z dwóch wartości pociągu wydania:

Wartość	Opis
`stable`	Domyślne.
`dev`	Wczesne wersje, które mogą zawierać funkcje eksperymentalne. Nie nadaje się do produkcji.

Na przykład:

--release-train stable

Konfigurowanie automatycznych aktualizacji na płaszczyźnie sterowania języka Dapr

Ostrzeżenie

Automatyczne uaktualnianie nie jest odpowiednie dla środowisk produkcyjnych. Włącz automatyczne aktualizacje płaszczyzny sterowania języka Dapr tylko w środowiskach deweloperskich lub testowych. Dowiedz się, jak ręcznie uaktualnić do najnowszej wersji języka Dapr dla środowisk produkcyjnych.

Jeśli zainstalujesz narzędzie Dapr bez określenia wersji, zostanie automatycznie włączone, --auto-upgrade-minor-version skonfigurowanie płaszczyzny sterowania Dapr w celu automatycznej aktualizacji jej wersji pomocniczej w nowych wersjach.

Możesz wyłączyć automatyczną --auto-upgrade-minor-version aktualizację, określając parametr i ustawiając wartość na false.

Przechowywanie wersji języka Dapr jest w MAJOR.MINOR.PATCH formacie, co oznacza 1.12.0 1.11.0, że jest to uaktualnienie wersji pomocniczej.

--auto-upgrade-minor-version true

Wyświetlanie najnowszych stabilnych wersji języka Dapr dostępnych

Aby przeprowadzić uaktualnienie do najnowszej wersji języka Dapr w środowisku produkcyjnym, należy ręcznie przeprowadzić uaktualnienie. Zacznij od wyświetlenia listy stabilnych wersji języka Dapr dostępnych dla zarządzanego klastra usługi AKS. Uruchom następujące polecenie:

az k8s-extension extension-types list-versions-by-cluster --resource-group <myResourceGroup> --cluster-name <myCluster> --cluster-type managedClusters --extension-type microsoft.dapr --release-train stable

Aby wyświetlić najnowszą stabilną wersję języka Dapr dostępną dla zarządzanego klastra usługi AKS, uruchom następujące polecenie:

az k8s-extension extension-types list-versions-by-cluster --resource-group <myResourceGroup> --cluster-name <myCluster> --cluster-type managedClusters --extension-type microsoft.dapr  --release-train stable --show-latest

Aby wyświetlić listę stabilnych wersji języka Dapr dostępnych według lokalizacji:

Upewnij się, że funkcja została zarejestrowana ExtenstionTypes w subskrypcji platformy Azure.
Uruchom następujące polecenie.

az k8s-extension extension-types list-versions-by-location --location westus --extension-type microsoft.dapr

Następnie ręcznie zaktualizuj narzędzie Dapr do najnowszej stabilnej wersji.

Określanie określonej wersji języka Dapr

Uwaga

Język Dapr jest obsługiwany w oknie kroczącym, w tym tylko bieżące i poprzednie wersje. Twoim zadaniem operacyjnym jest zachowanie aktualności tych obsługiwanych wersji. Jeśli masz starszą wersję języka Dapr, może być konieczne uaktualnienie pośrednie, aby przejść do obsługiwanej wersji.

Ten sam argument wiersza polecenia jest używany do instalowania określonej wersji języka Dapr lub wycofywania z poprzedniej wersji. Ustaw --auto-upgrade-minor-version wartość false i --version na wersję narzędzia Dapr, którą chcesz zainstalować. version Jeśli parametr zostanie pominięty, rozszerzenie instaluje najnowszą wersję języka Dapr. Aby na przykład użyć języka Dapr 1.13.5:

az k8s-extension create --cluster-type managedClusters \
--cluster-name <myAKSCluster> \
--resource-group <myResourceGroup> \
--name dapr \
--extension-type Microsoft.Dapr \
--auto-upgrade-minor-version false \
--version 1.13.5

Zanim rozpoczniesz

Rejestrowanie dostawcy `KubernetesConfiguration` zasobów

az provider list --query "[?contains(namespace,'Microsoft.KubernetesConfiguration')]" -o table

Dostawca Microsoft.KubernetesConfiguration powinien zgłosić wartość Zarejestrowano, jak pokazano w następujących przykładowych danych wyjściowych:

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

Jeśli dostawca jest wyświetlany jako NotRegistered, zarejestruj dostawcę przy użyciu polecenia az provider register , jak pokazano w poniższym przykładzie:

az provider register --namespace Microsoft.KubernetesConfiguration

Rejestrowanie funkcji w subskrypcji platformy `ExtenstionTypes` Azure

Ta funkcja musi zostać zarejestrowana ExtensionTypes w ramach subskrypcji platformy Azure. W terminalu sprawdź, czy jesteś w odpowiedniej subskrypcji:

az account set --subscription <YOUR-AZURE-SUBSCRIPTION-ID>

ExtenstionTypes Zarejestruj funkcję.

az feature registration create --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

Rejestracja funkcji może zająć trochę czasu. Po kilku minutach sprawdź stan rejestracji przy użyciu następującego polecenia:

az feature show --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

Wdrażanie rozszerzenia Dapr w klastrze Kubernetes z obsługą usługi AKS lub Arc

Utwórz szablon Bicep podobny do poniższego przykładu i wdróż rozszerzenie Dapr do istniejącego klastra.

@description('The name of the Managed Cluster resource.')
param clusterName string

resource existingManagedClusters 'Microsoft.ContainerService/managedClusters@2023-05-02-preview' existing = {
  name: clusterName
}

resource daprExtension 'Microsoft.KubernetesConfiguration/extensions@2022-11-01' = {
  name: 'dapr'
  scope: existingManagedClusters
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    autoUpgradeMinorVersion: true
    configurationProtectedSettings: {}
    configurationSettings: {
      'global.clusterType': 'managedclusters'
    }
    extensionType: 'microsoft.dapr'
    releaseTrain: 'stable'
    scope: {
      cluster: {
        releaseNamespace: 'dapr-system'
      }
    }
    version: '1.11.2'
  }
}

Ustaw następujące zmienne, zmieniając następujące wartości na rzeczywistą grupę zasobów i nazwy klastrów.

MY_RESOURCE_GROUP=<myResourceGroup>
MY_AKS_CLUSTER=<myAKSCluster>

Wdróż szablon Bicep przy użyciu az deployment group polecenia .

az deployment group create \
  --resource-group $MY_RESOURCE_GROUP \
  --template-file ./my-bicep-file-path.bicep \
  --parameters clusterName=$MY_AKS_CLUSTER

Konfigurowanie automatycznych aktualizacji na płaszczyźnie sterowania języka Dapr

Ostrzeżenie

Aktualizacje automatyczne można włączyć na płaszczyźnie sterowania języka Dapr tylko w środowiskach deweloperskich lub testowych. Automatyczne uaktualnianie nie jest odpowiednie dla środowisk produkcyjnych.

W przypadku wdrażania języka Dapr bez określania wersji zostanie automatycznie włączona, autoUpgradeMinorVersion skonfigurowanie płaszczyzny sterowania Dapr w celu automatycznej aktualizacji jej wersji pomocniczej w nowych wersjach.

Możesz wyłączyć automatyczną autoUpgradeMinorVersion aktualizację, określając parametr i ustawiając wartość na false.

Przechowywanie wersji języka Dapr jest w MAJOR.MINOR.PATCH formacie, co oznacza 1.12.0 1.11.0, że jest to uaktualnienie wersji pomocniczej.

properties {
  autoUpgradeMinorVersion: true
}

Określanie określonej wersji języka Dapr

Uwaga

Ustaw autoUpgradeMinorVersion wartość false i version na wersję narzędzia Dapr, którą chcesz zainstalować. autoUpgradeMinorVersion Jeśli parametr jest ustawiony na true, a version parametr zostanie pominięty, rozszerzenie instaluje najnowszą wersję języka Dapr.

Aby na przykład użyć języka Dapr 1.11.2:

properties: {
  autoUpgradeMinorVersion: false
  version: '1.11.2'
}

Wybieranie pociągu wydania

Podczas konfigurowania rozszerzenia możesz zainstalować środowisko Dapr z określonego szkolenia wydania. Określ jedną z dwóch wartości pociągu wydania:

Wartość	Opis
`stable`	Domyślne.
`dev`	Wczesne wersje, które mogą zawierać funkcje eksperymentalne. Nie nadaje się do produkcji.

Na przykład:

properties: {
  releaseTrain: 'stable'
}

Rozwiązywanie problemów z błędami rozszerzenia

Jeśli nie można utworzyć lub zaktualizować rozszerzenia, wypróbuj sugestie i rozwiązania w przewodniku rozwiązywania problemów z rozszerzeniem Dapr.

Rozwiązywanie problemów z dapr

Rozwiązywanie problemów z błędami języka Dapr za pośrednictwem typowych problemów i rozwiązań języka Dapr.

Usuwanie rozszerzenia

Jeśli musisz usunąć rozszerzenie i usunąć środowisko Dapr z klastra usługi AKS, możesz użyć następującego polecenia:

az k8s-extension delete --resource-group <myResourceGroup> --cluster-name <myAKSCluster> --cluster-type managedClusters --name dapr

Możesz też usunąć szablon Bicep.

Następne kroki

Konfigurowanie rozszerzenia Dapr dla unikatowego scenariusza

Udostępnij za pośrednictwem

Instalowanie rozszerzenia Dapr dla usługi Azure Kubernetes Service (AKS) i platformy Kubernetes z obsługą usługi Arc

Jak to działa

Wymagania wstępne

Zanim rozpoczniesz

Dodawanie rozszerzenia interfejsu wiersza polecenia platformy Azure dla rozszerzeń klastra

Rejestrowanie dostawcy `KubernetesConfiguration` zasobów

Rejestrowanie funkcji w subskrypcji platformy `ExtenstionTypes` Azure

Tworzenie rozszerzenia i instalowanie narzędzia Dapr w klastrze Kubernetes z obsługą usługi AKS lub arc

Aktualizowanie zarządzanego klastra usługi AKS do najnowszej wersji

Wybieranie pociągu wydania

Konfigurowanie automatycznych aktualizacji na płaszczyźnie sterowania języka Dapr

Wyświetlanie najnowszych stabilnych wersji języka Dapr dostępnych

Określanie określonej wersji języka Dapr

Zanim rozpoczniesz

Rejestrowanie dostawcy `KubernetesConfiguration` zasobów

Rejestrowanie funkcji w subskrypcji platformy `ExtenstionTypes` Azure

Wdrażanie rozszerzenia Dapr w klastrze Kubernetes z obsługą usługi AKS lub Arc

Konfigurowanie automatycznych aktualizacji na płaszczyźnie sterowania języka Dapr

Określanie określonej wersji języka Dapr

Wybieranie pociągu wydania

Rozwiązywanie problemów z błędami rozszerzenia

Rozwiązywanie problemów z dapr

Usuwanie rozszerzenia

Następne kroki

Dodatkowe zasoby

Udostępnij za pośrednictwem

Instalowanie rozszerzenia Dapr dla usługi Azure Kubernetes Service (AKS) i platformy Kubernetes z obsługą usługi Arc

Jak to działa

Wymagania wstępne

Zanim rozpoczniesz

Dodawanie rozszerzenia interfejsu wiersza polecenia platformy Azure dla rozszerzeń klastra

Rejestrowanie dostawcy KubernetesConfiguration zasobów

Rejestrowanie funkcji w subskrypcji platformy ExtenstionTypes Azure

Tworzenie rozszerzenia i instalowanie narzędzia Dapr w klastrze Kubernetes z obsługą usługi AKS lub arc

Aktualizowanie zarządzanego klastra usługi AKS do najnowszej wersji

Wybieranie pociągu wydania

Konfigurowanie automatycznych aktualizacji na płaszczyźnie sterowania języka Dapr

Wyświetlanie najnowszych stabilnych wersji języka Dapr dostępnych

Określanie określonej wersji języka Dapr

Rozwiązywanie problemów z błędami rozszerzenia

Rozwiązywanie problemów z dapr

Usuwanie rozszerzenia

Następne kroki

Dodatkowe zasoby

Rejestrowanie dostawcy `KubernetesConfiguration` zasobów

Rejestrowanie funkcji w subskrypcji platformy `ExtenstionTypes` Azure