Freigeben über


Schnellstart: Verwenden von Azure Container Storage (Version 1.x.x) mit Azure Kubernetes Service

Azure Container Storage ist ein cloudbasierter Volumeverwaltungs-, Bereitstellungs- und Orchestrierungsdienst, der nativ für Container erstellt wurde. In dieser Schnellstartanleitung erfahren Sie, wie Sie eine Verbindung mit einem Linux-basierten Azure Kubernetes Service (AKS) -Cluster herstellen, Azure Container Storage (Version 1.x.x) installieren und einen Speicherpool mit Azure CLI erstellen.

Von Bedeutung

In diesem Artikel wird erläutert, wie Sie Azure Container Storage (Version 1.x.x) installieren, der jetzt explizit einen Versionsheftungsparameter --container-storage-version 1 für die Installation erfordert. Azure Container Storage (Version 2.x.x) ist jetzt verfügbar.

Voraussetzungen

  • Wenn Sie noch kein Azure-Abonnement haben, erstellen Sie ein kostenloses Konto, bevor Sie beginnen.

  • Dieser Artikel erfordert die neueste Version der Azure CLI. Weitere Informationen finden Sie unter Installieren der Azure-Befehlszeilenschnittstelle. Wenn Sie die Bash-Umgebung in Azure Cloud Shell verwenden, ist die neueste Version bereits installiert. Wenn Sie beabsichtigen, die Befehle lokal statt in Azure Cloud Shell auszuführen, achten Sie darauf, sie mit Administratorrechten auszuführen. Weitere Informationen finden Sie unter "Erste Schritte mit Azure Cloud Shell".

  • Sie benötigen den Kubernetes-Befehlszeilenclient. kubectl Sie ist bereits installiert, wenn Sie Azure Cloud Shell verwenden, oder Sie können sie lokal installieren, indem Sie den az aks install-cli Befehl ausführen.

  • Überprüfen Sie, ob Ihre Zielregion in Azure Container Storage-Regionen unterstützt wird.

  • Wenn Sie noch keinen AKS-Cluster erstellt haben, befolgen Sie die Anweisungen zum Installieren eines AKS-Clusters.

Erste Schritte

  • Notieren Sie sich Ihre Azure-Abonnement-ID. Wenn Sie Azure Elastic SAN als Datenspeicher verwenden möchten, benötigen Sie entweder eine Azure Container Storage Owner-Rolle oder eine Azure Container Storage-Mitwirkenderrolle , die dem Azure-Abonnement zugewiesen ist. Der Zugriff auf Besitzerebene ermöglicht Ihnen die Installation der Azure Container Storage-Erweiterung, gewährt Zugriff auf seine Speicherressourcen und gewährt Ihnen die Berechtigung, Ihre Azure Elastic SAN-Ressource zu konfigurieren. Mitwirkenden-Zugriff ermöglicht die Installation der Erweiterung und gewährt Zugriff auf die Speicherressourcen der Erweiterung. Wenn Sie planen, Azure Disks oder Ephemeral Disk als Datenspeicher zu verwenden, benötigen Sie keine speziellen Berechtigungen für Ihr Abonnement.

  • Starten Sie Azure Cloud Shell, oder melden Sie sich mit dem Az-Anmeldebefehl bei Azure an, wenn Sie eine lokale Installation verwenden.

  • Wenn Sie Azure Cloud Shell verwenden, werden Sie möglicherweise aufgefordert, Den Speicher einzulagern. Wählen Sie das Azure-Abonnement aus, in dem Sie das Speicherkonto erstellen möchten, und wählen Sie "Erstellen" aus.

Installieren der erforderlichen Erweiterung

Fügen Sie die neueste Version k8s-extension hinzu, oder aktualisieren Sie sie, indem Sie den folgenden Befehl ausführen.

az extension add --upgrade --name k8s-extension

Festlegen des Abonnementkontexts

Legen Sie Ihren Azure-Abonnementkontext mithilfe des az account set Befehls fest. Sie können die Abonnement-IDs für alle Abonnements anzeigen, auf die Sie Zugriff haben, indem Sie den az account list --output table Befehl ausführen. Denken Sie daran, <subscription-id> durch Ihre Abonnement-ID zu ersetzen.

az account set --subscription <subscription-id>

Herstellen einer Verbindung mit dem Cluster

Verwenden Sie den Kubernetes-Befehlszeilenclient, kubectlum eine Verbindung mit dem Cluster herzustellen. Sie ist bereits installiert, wenn Sie Azure Cloud Shell verwenden, oder Sie können sie lokal installieren, indem Sie den az aks install-cli Befehl ausführen.

  1. Konfigurieren Sie kubectl, um mithilfe des Befehls „az aks get-credentials“ eine Verbindung mit Ihrem Cluster herzustellen. Der folgende Befehl:

    • Lädt Anmeldeinformationen herunter und konfiguriert die Kubernetes CLI für die Verwendung.
    • Verwendet ~/.kube/configden Standardspeicherort für die Kubernetes-Konfigurationsdatei. Sie können einen anderen Speicherort für Ihre Kubernetes-Konfigurationsdatei angeben, indem Sie das Argument "-file " verwenden.
    az aks get-credentials --resource-group <resource-group> --name <cluster-name>
    
  2. Überprüfen Sie die Verbindung mit dem Cluster mithilfe des Befehls kubectl get. Dieser Befehl gibt eine Liste der Clusterknoten zurück.

    kubectl get nodes
    
  3. Das folgende Ausgabebeispiel zeigt die Knoten in Ihrem Cluster. Stellen Sie sicher, dass der Status für alle Knoten "Bereit" angezeigt wird:

    NAME                                STATUS   ROLES   AGE   VERSION
    aks-nodepool1-34832848-vmss000000   Ready    agent   80m   v1.25.6
    aks-nodepool1-34832848-vmss000001   Ready    agent   80m   v1.25.6
    aks-nodepool1-34832848-vmss000002   Ready    agent   80m   v1.25.6
    

    Notieren Sie sich den Namen Ihres Knotenpools. In diesem Beispiel wäre dies "nodepool1".

Wählen Sie eine Datenspeicheroption für Ihren Speicherpool aus.

Bevor Sie Azure Container Storage bereitstellen, müssen Sie entscheiden, welche Back-End-Speicheroption Sie zum Erstellen Ihres Speicherpools und Ihrer Volumes verwenden möchten. Derzeit stehen drei Optionen zur Verfügung:

  • Azure Elastic SAN: Azure Elastic SAN eignet sich gut für allgemeine Datenbanken, Streaming- und Messagingdienste, CI/CD-Umgebungen und andere Workloads der Ebene 1/Ebene 2. Der Speicher wird bei Bedarf pro erstelltem Volume und erstellter Volumemomentaufnahme bereitgestellt. Mehrere Cluster können gleichzeitig auf ein einzelnes SAN zugreifen, persistente Volumes können jedoch nur jeweils von einem Verbraucher angefügt werden.

  • Azure Disks: Azure Disks eignen sich gut für Datenbanken wie MySQL, MongoDB und PostgreSQL. Der Speicher wird pro Größe des Zielcontainerspeicherpools und der maximalen Volumegröße bereitgestellt.

  • Ephemeral Disk: Diese Option verwendet lokale NVMe-Laufwerke oder temporäre SSD auf den AKS-Clusterknoten. Es ist äußerst latenzempfindlich (niedrige Unter-Ms-Latenz), daher eignet es sich am besten für Anwendungen ohne Datenbeständigkeitsanforderung oder mit integrierter Datenreplikationsunterstützung wie Cassandra. AKS ermittelt den verfügbaren kurzlebigen Speicher auf AKS-Knoten und ruft die Laufwerke für die Volumebereitstellung ab.

Hinweis

Für Azure Elastic SAN und Azure Disks stellt Azure Container Storage den Sicherungsspeicher für Sie als Teil der Installation bereit. Sie müssen kein eigenes Elastic SAN oder Azure Disk erstellen. Um Elastic SAN verwenden zu können, benötigen Sie entweder eine Azure Container Storage Owner-Rolle oder azure Container Storage-Mitwirkenderrolle im Azure-Abonnement.

Ressourcenverbrauch

Azure Container Storage erfordert bestimmte Knotenressourcen, um Komponenten für den Dienst auszuführen. Basierend auf ihrer Auswahl des Speicherpooltyps, die Sie beim Installieren von Azure Container Storage angeben, sind dies die Ressourcen, die verbraucht werden:

Speicherpooltyp CPU-Kerne RAM
Azure Elastic SAN  Nichts Nichts
Azure-Datenträger 1 1 GiB
Flüchtiger Datenträger - Temp SSD 1 1 GiB
Ephemeral Disk - Local NVMe (Standardebene) 25 % der Prozessorkerne (Leistungsebene kann aktualisiert werden)* 1 GiB

Die verbrauchten Ressourcen sind pro Knoten und werden für jeden Knoten im Knotenpool genutzt, in dem Azure Container Storage installiert wird. Wenn Ihre Knoten nicht über genügend Ressourcen verfügen, kann Azure Container Storage nicht ausgeführt werden. Kubernetes versucht automatisch erneut, diese fehlgeschlagenen Pods zu initialisieren. Wenn Also Ressourcen befreit werden, können diese Pods erneut initialisiert werden.

*Beim Speicherpooltyp „Kurzlebiger Datenträger – Lokaler NVMe-Datenträger“ mit der Leistungsstufe „Standard“ (Standardeinstellung) gelten die 25 % verbrauchter CPU-Kerne für die kleinste verwendete SKU, wenn Sie mehrere VM-SKU-Typen für Ihre Clusterknoten verwenden. Wenn Sie beispielsweise eine Mischung aus 8-Kern- und 16-Kern-VM-Typen verwenden, beträgt der Ressourcenverbrauch 2 Kerne. Sie können die Leistungsebene aktualisieren , um einen größeren Prozentsatz der Kerne zu verwenden und höhere IOPS zu erzielen.

Stellen Sie sicher, dass der VM-Typ für Ihren Cluster die folgenden Kriterien erfüllt.

Um Azure Container Storage zu verwenden, benötigen Sie einen Knotenpool von mindestens drei Linux-VMs. Jeder virtuelle Computer sollte mindestens vier virtuelle CPUs (vCPUs) aufweisen. Azure Container Storage verwendet einen Kern für die E/A-Verarbeitung auf jedem virtuellen Computer, auf dem die Erweiterung bereitgestellt wird.

Befolgen Sie diese Richtlinien, wenn Sie einen VM-Typ für die Clusterknoten auswählen. Sie müssen einen VM-Typ auswählen, der Azure Premium Storage unterstützt.

  • Wenn Sie beabsichtigen, Azure Elastic SAN oder Azure Disks als Sicherungsspeicher zu verwenden, wählen Sie einen allgemeinen VM-Typ wie standard_d4s_v5 aus.
  • Wenn Sie beabsichtigen, ephemerale Datenträger mit lokalem NVMe zu verwenden, wählen Sie eine VM-SKU aus, die lokale NVMe-Datenträger unterstützt, z. B. speicheroptimierte VM-SKUs oder GPU-beschleunigte VM-SKUs.
  • Wenn Sie beabsichtigen, ephemeral Disk mit temp SSD zu verwenden, wählen Sie einen virtuellen Computer mit einem temporären SSD-Datenträger wie Ev3 und Esv3-Serie aus.

Installieren von Azure Container Storage auf Ihrem AKS-Cluster

Der Installationsbefehl unterscheidet sich je nachdem, ob Sie bereits über eine Vorschauinstanz von Azure Container Storage verfügen, die auf Ihrem AKS-Cluster ausgeführt wird, oder ob Sie Azure Container Storage zum ersten Mal auf dem Cluster installieren.

Aktualisieren einer Vorschauinstallation auf allgemeine Verfügbarkeit

Wenn Sie bereits über eine Vorschauinstanz von Azure Container Storage verfügen, die auf Ihrem Cluster ausgeführt wird, empfehlen wir, die neueste allgemein verfügbare (GA)-Version zu aktualisieren, indem Sie den folgenden Befehl ausführen. Wenn Sie Azure Container Storage zum ersten Mal auf dem Cluster installieren, fahren Sie stattdessen mit der Installation von Azure Container Storage fort, und erstellen Sie einen Speicherpool. Sie können azure Container Storage auch in bestimmten Knotenpools installieren.

az k8s-extension update --cluster-type managedClusters --cluster-name <cluster-name> --resource-group <resource-group> --name azurecontainerstorage --version 1.1.0 --auto-upgrade false --release-train stable

Denken Sie daran, <cluster-name> und <resource-group> durch Ihre eigenen Werte zu ersetzen.

Installieren von Azure Container Storage und Erstellen eines Speicherpools

Stellen Sie vor der Installation sicher, dass Ihr AKS-Cluster die VM-Anforderungen erfüllt.

Führen Sie den folgenden Befehl aus, um Azure Container Storage auf dem Cluster zu installieren und einen Speicherpool zu erstellen. Ersetzen Sie <cluster-name> und <resource-group> durch Ihre eigenen Werte. Ersetzen Sie <storage-pool-type> durch azureDisk, ephemeralDisk oder elasticSan. Wenn Sie auswählen ephemeralDisk, können Sie auch angeben --storage-pool-option, und die Werte können NVMe sein oder Temp.

Wenn Sie diesen Befehl ausführen, wird Azure Container Storage im Systemknotenpool aktiviert, der standardmäßig "*" heißt nodepool1. Wenn Sie es in anderen Knotenpools aktivieren möchten, lesen Sie Installieren von Azure Container Storage auf bestimmten Knotenpools. Wenn Sie zusätzliche Parameter angeben möchten, lesen Sie die Parameter des Azure Container Storage-Speicherpools.

*Wenn vorhandene Knotenpools mit der acstor.azure.com/io-engine:acstor Bezeichnung vorhanden sind, wird Azure Container Storage standardmäßig dort installiert. Andernfalls wird sie im Systemknotenpool installiert.

Von Bedeutung

Wenn Sie Ihren AKS-Cluster mithilfe des Azure-Portals erstellt haben: Der Cluster verfügt wahrscheinlich über einen Benutzerknotenpool und einen System-/Agent-Knotenpool. Wenn Ihr Cluster jedoch nur aus einem Systemknotenpool besteht. Dies ist der Fall bei Test-/Entwicklungsclustern, die mit dem Azure-Portal erstellt wurden, müssen Sie zuerst einen neuen Benutzerknotenpool hinzufügen und dann mit der Bezeichnung versehen. Dies liegt daran, dass beim Erstellen eines AKS-Clusters mithilfe des Azure-Portals dem System-/Agent-Knotenpool ein Taint CriticalAddOnsOnly hinzugefügt wird, der die Installation von Azure Container Storage im Systemknotenpool blockiert. Dieser Taint wird nicht hinzugefügt, wenn ein AKS-Cluster mithilfe von Azure CLI erstellt wird.

Wenn Sie einen Multizonen-AKS-Cluster mit Azure Elastic SAN verwenden: Sie müssen einen zonenredundanten Speicher (ZRS) Elastic SAN verwenden. Der Standardwert für einen Elastic SAN-Speicherpool ist lokal redundanter Speicher (LRS). Um ZRS für Elastic SAN zu aktivieren, verwenden Sie elasticSan für den Speicherpooltyp und fügen Sie das --storage-pool-sku Premium_ZRS-Flag dem folgenden CLI-Befehl hinzu.

az aks update -n <cluster-name> -g <resource-group> --enable-azure-container-storage <storage-pool-type> --container-storage-version 1

Die Bereitstellung dauert 10-15 Minuten. Nach Abschluss des Vorgangs ist ein AKS-Cluster mit Azure Container Storage installiert, die Komponenten für den ausgewählten Speicherpooltyp aktiviert und ein Standardspeicherpool. Wenn Sie zusätzliche Speicherpooltypen zum Erstellen zusätzlicher Speicherpools aktivieren möchten, lesen Sie "Aktivieren zusätzlicher Speicherpooltypen".

Von Bedeutung

Wenn Sie Azure Elastic SAN als Sicherungsspeicher für Ihren Speicherpool angegeben haben und weder die Rolle des Azure Container Storage Owners noch die des Azure Container Storage Contributors im Azure-Abonnement zugewiesen haben, schlägt die Installation von Azure Container Storage fehl, und ein Speicherpool wird nicht erstellt. Wenn Sie versuchen, Azure Elastic SAN als zusätzlichen Speicherpooltyp ohne eine dieser Rollen zu aktivieren, bleiben Ihre vorherigen Installations- und Speicherpools unberührt, und ein Elastic SAN-Speicherpool wird nicht erstellt.

Installieren von Azure Container Storage in bestimmten Knotenpools

Wenn Sie Azure Container Storage in bestimmten Knotenpools installieren möchten, befolgen Sie diese Anweisungen. Die Knotenpools müssen mindestens drei Linux-VMs enthalten.

  1. Führen Sie den folgenden Befehl aus, um die Liste der verfügbaren Knotenpools anzuzeigen. Ersetzen Sie <resource-group> und <cluster-name> durch Ihre eigenen Werte.

    az aks nodepool list --resource-group <resource-group> --cluster-name <cluster-name>
    
  2. Führen Sie den folgenden Befehl aus, um Azure Container Storage in bestimmten Knotenpools zu installieren. Ersetzen Sie <cluster-name> und <resource-group> durch Ihre eigenen Werte. Ersetzen Sie <storage-pool-type> durch azureDisk, ephemeralDisk oder elasticSan. Wenn Sie ephemeralDisk auswählen, können Sie auch die Option "--storage-pool-option" angeben, und die Werte können NVMe oder Temp sein.

    az aks update -n <cluster-name> -g <resource-group> --enable-azure-container-storage <storage-pool-type> --container-storage-version 1 --azure-container-storage-nodepools <comma separated values of nodepool names>
    

Aktivieren zusätzlicher Speicherpooltypen

Wenn Sie einen Speicherpooltyp aktivieren möchten, der während der Installation von Azure Container Storage ursprünglich nicht aktiviert wurde, führen Sie den folgenden Befehl aus. Ersetzen Sie <cluster-name> und <resource-group> durch Ihre eigenen Werte. Geben Sie für <storage-pool-type> entweder azureDisk, ephemeralDisk oder elasticSan an.

Wenn Sie zusätzliche Speicherpoolparameter mit diesem Befehl angeben möchten, lesen Sie diese Tabelle.

az aks update -n <cluster-name> -g <resource-group> --enable-azure-container-storage <storage-pool-type> --container-storage-version 1

Wenn der neue Speicherpooltyp, den Sie aktiviert haben, mehr Ressourcen beansprucht als der bereits aktivierte Speicherpooltyp, ändert sich der Ressourcenverbrauch in den maximalen Betrag.

Tipp

Wenn Sie Ihrem Cluster einen neuen Knotenpool hinzugefügt haben und Azure Container Storage auf diesem Knotenpool ausführen möchten, können Sie den Knotenpool angeben, wenn --azure-container-storage-nodepools <nodepool-name> der az aks update Befehl ausgeführt wird.

Anzeigen verfügbarer Speicherpools

Führen Sie den folgenden Befehl aus, um die Liste der verfügbaren Speicherpools abzurufen:

kubectl get sp -n acstor

Führen Sie den folgenden Befehl aus, um den Status eines Speicherpools zu überprüfen:

kubectl describe sp <storage-pool-name> -n acstor

Wenn Message nicht StoragePool is ready lautet, wird der Speicherpool noch erstellt, oder es ist ein Problem aufgetreten. Siehe Problembehandlung bei Azure Container Storage.

Deaktivieren von Speicherpooltypen

Wenn Sie keinen bestimmten Speicherpooltyp mehr verwenden und ihn deaktivieren möchten, um Ressourcen in Ihrem Knotenpool freizugeben, führen Sie den folgenden Befehl aus. Ersetzen Sie <cluster-name> und <resource-group> durch Ihre eigenen Werte. Geben Sie für <storage-pool-type> entweder azureDisk, ephemeralDisk oder elasticSan an.

az aks update -n <cluster-name> -g <resource-group> --disable-azure-container-storage <storage-pool-type>

Hinweis

Wenn Sie über einen vorhandenen Speicherpool des Typs verfügen, den Sie deaktivieren möchten, wird der Speicherpooltyp nicht deaktiviert.

Nächster Schritt

Um Volumes zu erstellen, wählen Sie den Link für den ausgewählten Sicherungsspeichertyp aus.