Udostępnij przez


Tworzenie i konfigurowanie przestrzeni nazw zarządzanej floty (wersja zapoznawcza)

Dotyczy: ✔️ Fleet Manager z klastrem hubowym

W tym artykule pokazano, jak za pomocą programu Fleet Manager utworzyć i skonfigurować przestrzeń nazw zarządzanej floty, która definiuje przydziały zasobów, zasady sieciowe i delegowany dostęp użytkowników dla przestrzeni nazw w wielu klastrach.

Jeśli chcesz wyświetlić lub uzyskać dostęp do istniejących przestrzeni nazw floty zarządzanej, do których masz dostęp, zobacz Wyświetlanie przestrzeni nazw floty zarządzanej i uzyskiwanie do tego dostępu.

Ważne

Funkcje usługi Azure Kubernetes Fleet Manager w wersji zapoznawczej są dostępne na zasadzie samoobsługi. Wersje zapoznawcze są udostępniane w wersji "as is" i "jako dostępne" i są wykluczone z umów dotyczących poziomu usług i ograniczonej gwarancji. Wersje zapoznawcze usługi Azure Kubernetes Fleet Manager są częściowo objęte pomocą techniczną świadczoną w miarę możliwości. W związku z tym te funkcje nie są przeznaczone do użytku produkcyjnego.

Znane ograniczenia

  • Gdy przestrzeń nazw zarządzanej floty przyjmuje przestrzeń nazw Kubernetes zarządzaną w jednym klastrze lub odwrotnie, może to prowadzić do konfliktu własności. Aby tego uniknąć, należy użyć zasady usuwania keep zarówno dla przestrzeni nazw Managed Fleet, jak i Kubernetes.
  • Klastry muszą być członkami zarządzanymi przez usługę Fleet Manager hostująca przestrzeń nazw zarządzanej floty.
  • Klastry muszą mieć wersję kubernetes co najmniej 1.30.0. Klastry poniżej tej wersji nie blokują użytkownikom w klastrze modyfikowania umieszczonych zasobów platformy Kubernetes.
  • Role RBAC przypisane do zakresu przestrzeni nazw floty zarządzanej zapewniają równoważny dostęp do wszystkich niezarządzanych przestrzeni nazw Kubernetes o tej samej nazwie w klastrach członkowskich.

Zanim rozpoczniesz

  • Aby ukończyć ten artykuł, musisz zainstalować interfejs wiersza polecenia platformy Azure w wersji 2.78.0 lub nowszej. Aby zainstalować lub uaktualnić, zobacz Instalowanie interfejsu wiersza polecenia platformy Azure.

  • Potrzebujesz rozszerzenia interfejsu wiersza polecenia platformy fleet Azure w wersji 1.8.0 lub nowszej. Można zainstalować i zaktualizować do najnowszej wersji za pomocą poleceń az extension add i az extension update.

    # Install the extension
    az extension add --name fleet
    
    # Update the extension
    az extension update --name fleet
    
  • Upewnij się, że wersja rozszerzenia floty wynosi co najmniej 1.8.0, używając polecenia az extension show.

    az extension show --name fleet
    
  • Ustaw następujące zmienne środowiskowe dla identyfikatora subskrypcji, grupy zasobów, floty i członka floty.

    export SUBSCRIPTION_ID=<subscription-id>
    export GROUP=<resource-group-name>
    export FLEET=<fleet-name>
    export FLEET_ID=<fleet-id>
    
  • Ustaw subskrypcję Azure jako domyślną przy użyciu polecenia az account set.

    az account set --subscription ${SUBSCRIPTION_ID}
    

Tworzenie nowej przestrzeni nazw zarządzanej floty

Utwórz nową przestrzeń nazw zarządzanej floty za pomocą polecenia az fleet namespace create.

    az fleet namespace create \
        --resource-group $GROUP \
        --fleet-name $FLEET \
        --name my-managed-namespace \ 
        --annotations annotation1=value1 annotation2=value2 \
        --labels team=myTeam label2=value2 \
        --cpu-requests 1m \
        --cpu-limits 4m \
        --memory-requests 1Mi \
        --memory-limits 4Mi \
        --ingress-policy allowAll \
        --egress-policy allowAll \
        --delete-policy keep \
        --adoption-policy never

Uwaga / Notatka

Te ustawienia są opcjonalne: zasady sieciowe, limit przydziału zasobów obliczeniowych, usuwanie i zasady wdrażania, etykiety i adnotacje.

W przypadku korzystania z zasad sieci użytkownicy z akcją Microsoft.ContainerService/managedClusters/networking.k8s.io/networkpolicies/write, na przykład Azure Kubernetes Service RBAC Writer, w roli Microsoft Entra ID mogą dodawać więcej zasad sieci za pośrednictwem API Kubernetes.

Jeśli na przykład administrator stosuje Deny All zasady dla ruchu przychodzącego/wychodzącego, a użytkownik stosuje Allow zasady dla przestrzeni nazw za pośrednictwem interfejsu API Kubernetes, Allow zasady mają priorytet nad Deny All zasadami, a ruch może przepływać dla przestrzeni nazw. To zachowanie addytywne jest standardowe w przypadku zasad sieciowych.

Przypisywanie dostępu użytkowników lub grup

Teraz możesz udzielić dostępu użytkownikowi dla przestrzeni nazw zarządzanej floty w klastrach członkowskich przy użyciu jednej z wbudowanych ról RBAC platformy Azure.

Utwórz przypisanie roli za pomocą polecenia az role assignment create.

W poniższym przykładzie przypisano użytkownikowi rolę autora RBAC w usłudze Azure Kubernetes Fleet Manager dla klastrów członkowskich w dowolnym klastrze, który odbiera przestrzeń nazw zarządzanego zespołu:

az role assignment create \
    --role "Azure Kubernetes Fleet Manager RBAC Writer for Member Clusters" \
    --assignee <USER-ENTRA-ID> \
    --scope "$FLEET_ID/managedNamespaces/my-managed-namespace"

Dodawanie klastrów członkowskich

Możesz kontrolować, które klastry członkowskie mają wdrożyć zarządzaną przestrzeń nazw, określając żądaną listę nazw klastrów członkowskich.

Określ pełną listę klastrów członkowskich, do których chcesz wdrożyć zarządzaną przestrzeń nazw przy użyciu az fleet namespace create polecenia z parametrem --member-cluster-names . Zarządzana przestrzeń nazw jest propagowana do wszystkich klastrów na liście.

W tym przykładzie zarządzana przestrzeń nazw jest wdrażana do contoso-prd-01-fm i contoso-prd-02-fm.

az fleet namespace create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name my-managed-namespace \
    --member-cluster-names contoso-prd-01-fm contoso-prd-02-fm

Usuwanie klastrów składowych

Klastry członkowskie można usunąć z przestrzeni nazw floty zarządzanej, wykluczając je z listy klastrów, w których ma być przestrzeń nazw.

Określ listę klastrów członkowskich, na których ma pozostać zarządzana przestrzeń nazw przy użyciu az fleet namespace create polecenia z parametrem --member-cluster-names . Zarządzana przestrzeń nazw jest usuwana z wszystkich klastrów wykluczonych z listy.

W tym przykładzie zarządzana przestrzeń nazw jest usuwana z contoso-prd-02-fm.

az fleet namespace create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name my-managed-namespace \
    --member-cluster-names contoso-prd-01-fm

Wyświetlanie konfiguracji przestrzeni nazw floty zarządzanej

Aby wyświetlić szczegóły określonej przestrzeni nazw zarządzanej floty, użyj polecenia az fleet namespace show.

az fleet namespace show \ 
    --resource-group $GROUP \ 
    --fleet-name $FLEET \ 
    --name my-managed-namespace \ 
    -o table 

Dane wyjściowe powinny przypominać następujące przykładowe dane wyjściowe:

AdoptionPolicy  DeletePolicy   ETag                                    Location   Name                  ProvisioningState   ResourceGroup
--------------  ------------   -------------------------------------   --------   --------------------  -----------------   -------------
Always          Delete         "aaaaaaaa-0b0b-1c1c-2d2d-333333333333   westus2    my-managed-namespace  Succeeded           test-rg

Usuń przestrzeń nazw zarządzanej floty

Usuń przestrzeń nazw zarządzanej floty, używając polecenia az fleet namespace delete.

az fleet namespace delete \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name my-managed-namespace 

Ostrzeżenie

Usuwanie przestrzeni nazw zarządzanej przez flotę z ustawieniem DeletePolicydelete jest trwałą akcją. Jeśli nie masz pewności, zaktualizuj politykę, aby keep zachować przestrzeń nazw.

Przypisania RBAC platformy Azure są zawsze usuwane, aby uniknąć zwisania uprawnień.

Tworzenie nowej przestrzeni nazw zarządzanej floty

Możesz utworzyć nową przestrzeń nazw floty zarządzanej z poziomu usługi Fleet Manager lub za pośrednictwem centrum Kubernetes.

Począwszy od programu Fleet Manager:

  • W witrynie Azure Portal przejdź do zasobu usługi Azure Kubernetes Fleet Manager.
  • Po lewej stronie, w sekcji Zasoby floty, wybierz Przestrzenie nazw.
  • Wybierz z menu pozycję + Utwórz, a następnie pozycję Zarządzana przestrzeń nazw dla floty.

Zrzut ekranu przedstawiający menu portalu Azure służące do tworzenia przestrzeni nazw zarządzanej floty w usłudze Azure Kubernetes Fleet Manager.

Rozpoczynanie w centrum Kubernetes:

Zrzut ekranu przedstawiający menu Centrum Kubernetes w portalu Azure, służące do tworzenia przestrzeni nazw zarządzanej floty.

  • Wybierz jedną z następujących opcji dla pozycji Zakres:
    • Nowy — utwórz nową przestrzeń nazw Kubernetes, która nie istnieje w klastrze głównym Fleet Manager. Wprowadź nazwę nowej przestrzeni nazw.
    • Przekonwertuj na zarządzaną — użyj istniejącej przestrzeni nazw Kubernetes w klastrze centrum Fleet Manager. Wybierz Namespace z listy przestrzeni nazw w klastrze centrum Fleet Manager.

Zrzut ekranu portalu Azure przedstawiający kartę Podstawy z ukończonymi szczegółami projektu dla nowej zarządzanej przestrzeni nazw floty.

Przypisywanie dostępu użytkowników lub grup

Wybierz użytkowników i grupy Microsoft Entra, które uzyskują dostęp do Managed Fleet Namespace w klastrach, do których jest dystrybuowana.

Zrzut ekranu witryny Azure Portal przedstawiający ukończone szczegóły dostępu dla nowej przestrzeni nazw floty zarządzanej.

Uwaga / Notatka

Ten krok jest opcjonalny. Przestrzeń nazw zarządzanej floty można tworzyć i dystrybuować bez przypisywania użytkowników lub grup. Dzięki temu można dystrybuować przestrzeń nazw bez natychmiastowego udzielania dostępu.

Dodawanie zasad sieciowych i limitu przydziału zasobów obliczeniowych

Kontroluj przepływ ruchu sieciowego do i z przestrzeni nazw w każdym z klastrów, do których jest ona dystrybuowana, oraz definiuj przydziały zasobów CPU i pamięci dla przestrzeni nazw.

Zrzut ekranu portalu Azure przedstawiający ukończone zasady sieciowe i limit zasobów obliczeniowych dla nowej przestrzeni nazw zarządzanej floty.

Uwaga / Notatka

Te ustawienia są opcjonalne. Przestrzeń nazw zarządzanej floty można tworzyć i dystrybuować bez zastosowania zasad sieciowych ani kontroli przydziałów.

Użytkownicy z akcją Microsoft.ContainerService/managedClusters/networking.k8s.io/networkpolicies/write, taką jak Azure Kubernetes Service RBAC Writer, w roli Microsoft Entra ID, do której są przypisani, mogą dodawać więcej zasad sieci za pośrednictwem interfejsu API Kubernetes.

Jeśli na przykład administrator stosuje Deny All zasady dla ruchu przychodzącego/wychodzącego, a użytkownik stosuje Allow zasady dla przestrzeni nazw za pośrednictwem interfejsu API Kubernetes, Allow zasady mają priorytet nad Deny All zasadami, a ruch może przepływać dla przestrzeni nazw. To zachowanie addytywne jest standardowe w przypadku zasad sieciowych.

Wybieranie klastrów członkowskich

Zdefiniuj klastry członkowskie do dystrybucji zarządzanej przestrzeni nazw, dodając je w następujący sposób.

  • Z menu wybierz pozycję + Dodaj.
  • W oknie dialogowym Wybieranie klastrów członkowskich wyszukaj klastry członkowskie i zaznacz je, zaznaczając pole wyboru.
  • Na koniec wybierz pozycję Wybierz , aby dodać klastry członkowskie.

Zrzut ekranu witryny Azure Portal przedstawiający dwa klastry członkowskie wybrane do hostowania nowej przestrzeni nazw floty zarządzanej.

Uwaga / Notatka

Ten krok jest opcjonalny. Jeśli nie podasz żadnych klastrów członkowskich, przestrzeń nazw zarządzanej floty zostanie wdrożona tylko w klastrze centralnym Fleet Manager. Klastry członkowskie można dodawać później.

Ustawianie etykiet, adnotacji i tagów

Zdefiniuj opcjonalne etykiety i adnotacje platformy Kubernetes oraz tagi usługi Azure Resource Manager (ARM), które zapewniają metadane, które mogą być używane do automatyzacji i zarządzania zasobami.

Zrzut ekranu witryny Azure Portal przedstawiający ustawienia etykiet i adnotacji dla nowej przestrzeni nazw floty zarządzanej.

Uwaga / Notatka

Ten krok jest opcjonalny. W późniejszym czasie można zarządzać etykietami, adnotacjami i tagami.

Tworzenie przestrzeni nazw zarządzanej floty

Po skonfigurowaniu wszystkich właściwości nowej przestrzeni nazw floty zarządzanej można potwierdzić szczegóły przed utworzeniem przestrzeni nazw, wybierając pozycję Utwórz.

Wdrożenie usługi Azure Resource Manager jest natychmiast uruchamiane, co inicjuje umieszczanie obciążenia usługi Fleet Manager w celu dystrybucji przestrzeni nazw do wybranych klastrów.

Po zakończeniu wdrażania możesz znaleźć przestrzeń nazw floty zarządzanej na liście przestrzeni nazw programu Fleet Manager.

Zrzut ekranu portalu Azure z nową zarządzaną przestrzenią nazw flot wymienioną obok innych przestrzeni nazw w klastrze węzłowym.

Aby przejrzeć wdrożenie przestrzeni nazw Kubernetes w klastrach, użyj funkcji Umieszczanie zasobów, wyszukując rozmieszczenie zasobów o takiej samej nazwie jak przestrzeń nazw zarządzanej floty.

Zrzut ekranu witryny Azure Portal przedstawiający stan umieszczania zasobów nowej przestrzeni nazw floty zarządzanej.

Konfigurowanie istniejącej przestrzeni nazw floty zarządzanej

Przestrzeń nazw zarządzanej floty można znaleźć w programie Fleet Manager lub za pośrednictwem centrum Kubernetes.

Począwszy od programu Fleet Manager:

  • W witrynie Azure Portal przejdź do zasobu usługi Azure Kubernetes Fleet Manager.
  • W menu po lewej stronie, w sekcji Zasoby floty, wybierz opcję Przestrzenie nazw.

Począwszy od centrum kubernetes:

Modyfikowanie konfiguracji

Zmodyfikuj zasady sieciowe, przydziały zasobów, etykiety, adnotacje i tagi, klikając edytuj obok odpowiedniego elementu na ekranie przeglądu Przestrzeni Nazw Zarządzanej Floty.

Wybranie pozycji Edytuj obok etykiet, adnotacji lub tagów powoduje otwarcie okna dialogowego, w którym można zmodyfikować dowolny z tych trzech elementów.

Wybranie opcji edytuj obok dowolnego z zasad sieciowych lub opcji przydziału zasobów powoduje otwarcie okna dialogowego, w którym można zmodyfikować dowolny z tych elementów.

Zrzut ekranu witryny Azure Portal przedstawiający ekran przeglądu przestrzeni nazw zarządzanej floty z wyróżnionymi opcjami edycji w czerwonych polach.

Modyfikowanie dostępu użytkowników lub grup

Przestrzeń nazw zarządzanej floty to zasób usługi Azure Resource Manager (ARM), więc zarządzanie dostępem użytkowników i grup można osiągnąć, wybierając pozycję Kontrola dostępu (IAM) w lewym obszarze nawigacji na ekranie przeglądu Zarządzanie przestrzenią nazw floty.

Modyfikowanie klastrów składowych

Na przeglądzie przestrzeni nazw zarządzanej floty wybierz pozycję Klastry członkowskie w lewej nawigacji.

Aby usunąć klastry członkowskie:

  • Zaznacz klastry do usunięcia, zaznaczając pole po lewej stronie wiersza.
  • W górnej nawigacji wybierz pozycję Usuń.
  • Potwierdź akcję i wybierz pozycję Usuń.

Aby dodać klastry członkowskie:

  • Z menu wybierz pozycję + Dodaj.
  • W oknie dialogowym Dodaj klastry członkowskie wyszukaj klastry członkowskie i zaznacz je, zaznaczając pole wyboru.
  • Na koniec wybierz pozycję Dodaj , aby dodać klastry członkowskie.

Zrzut ekranu witryny Azure Portal przedstawiający wybrany jeden klaster członkowski gotowy do usunięcia z przestrzeni nazw floty zarządzanej.

Po zmodyfikowaniu klastrów hostujących przestrzeń nazw zarządzanej floty, przegląd zostanie zaktualizowany, aby wyświetlać klastry aktywnie hostujące przestrzeń nazw.

Usuń przestrzeń nazw zarządzanej floty

Na przeglądzie przestrzeni nazw flotą zarządzaną, wybierz Usuń w górnym pasku nawigacyjnym.

W potwierdzeniu Usuń przestrzeń nazw zarządzanej floty wybierz odpowiednią opcję:

  • Zachowaj przestrzeń nazw Kubernetes, usuń możliwości zarządzania: Zarządzana przestrzeń nazw floty jest konwertowana na standardową przestrzeń nazw Kubernetes, pozostającą w klastrze głównym oraz klastrach członkowskich Fleet Manager, ale nie jest już zarządzana przez Azure Resource Manager (ARM).
  • Usuń przestrzeń nazw i wszystkie skojarzone zasoby: zasób ARM Przestrzeni Nazw Zarządzanej Floty jest usuwany wraz z przestrzenią nazw Kubernetes zarówno w klastrze Centrum Zarządzania Flotą, jak i w klastrach członkowskich.

Ostrzeżenie

Usunięcie przestrzeni nazw i wszystkich skojarzonych zasobów jest trwałą akcją. Jeśli nie masz pewności, musisz wybrać opcję zachowania przestrzeni nazw.

W obu przypadkach przypisania RBAC platformy Azure są usuwane, aby uniknąć zbędnych uprawnień.

Dalsze kroki