Registrierung von Infrastrukturressourcen mit der Mesh CLI

Um Ihre Infrastrukturressourcen zu registrieren, müssen Sie Mesh Details über die Cloud- und On-Premise-Infrastruktur zur Verfügung stellen, auf der Ihre Anwendungen ausgeführt werden. Sie können die CLI zur Registrierung verwenden.

Alternativ können Sie Ihre Infrastrukturressourcen auch durch automatische Erkennung registrieren. Informationen zur Registrierung durch automatische Erkennung finden Sie unter Erkennung der Cloud-Infrastruktur.

Voraussetzungen

Weitere Informationen finden Sie unter Installieren der CLI.

Übersicht

Ihre Infrastrukturressourcen verfügen über eine Hierarchie, und es ist erforderlich, die Ressourcen in der Reihenfolge von der breitesten bis zur spezifischsten zu registrieren:

  • Cloudimplementierungen
    • Standort
    • vpc (virtuelle private Cloud)
      • securitygroup
    • Cluster
      • Namensbereich
    • Knoten (virtuelle Maschine oder Bare-Metal-Server)

Die Implementierungsumgebung ist der abstrakte Begriff, den Mesh für VPCs (Virtual Private Cloud), Cluster und Knoten verwendet. Partition ist der abstrakte Begriff für Namespaces und Sicherheitsgruppen. Der primäre Zweck der Registrierung Ihrer Infrastruktur besteht darin, die Implementierungsumgebungen und Partitionen zu beschreiben, in denen Ihre Anwendungen ausgeführt werden.

Clouds registrieren

Registrieren Sie jede Cloud, die Anwendungen enthält, zu denen Mesh eine Verbindung herstellen soll. Um eine Wolke zu registrieren, verwenden Sie den Befehl palmctl create cloud .

Bevor Sie die Cloud-Ressource registrieren, entscheiden Sie, ob Sie die entdeckten Ressourcen in der Standard-Infrastrukturgruppe ( Default_Infrastructure_Group) oder in einer anderen Ressourcengruppe platzieren möchten.

Um die entdeckten Ressourcen in Default_Infrastructure_Group zu speichern, setzen Sie die folgende Umgebungsvariable:
RESOURCE_GROUP_ID='default-infra'

Um die ermittelten Ressourcen einer anderen Ressourcengruppe zuzuordnen, führen Sie die folgenden Schritte aus:

  • Erstellen Sie die Ressourcengruppe. Weitere Informationen finden Sie unter Ressourcengruppen.
  • Nachdem Sie den Befehl palmctl create cloud ausgeführt haben, notieren Sie den Wert des Feldes resource_id in der Ausgabe. Setzen Sie den Wert der Shell-Variablen RESOURCE_GROUP_ID auf den Wert resource_id .

Um eine AWS -Wolke zu registrieren, führen Sie einen Befehl wie diesen aus:

cat << EOM | palmctl create cloud -f -
name: AWS
type: AWS
is_private: false
EOM
  • Der Wert des Felds name kann beliebig sein, solange er eindeutig ist.
  • Die gültigen Werte für type sind: IBM, AWS, GCP, Azure, und other.
    Hinweis: Sie können die automatische Erkennung nicht auf Wolken des Typs other ausführen.
  • Legen Sie die folgenden Werte fest, um alle Ihre vor Ort befindlichen Rechenzentren darzustellen:
    • Setzen Sie type auf other .
    • Setzen Sie is_private auf true .
  • Es wird keine Ressourcengruppen-ID angegeben, so dass die gefundenen Ressourcen in Default_Infrastructure_Group platziert werden.

Um eine Cloud mithilfe von Umgebungsvariablen zu registrieren, die automatische Erkennung zu aktivieren und ein Geheimnis anzugeben, führen Sie einen Befehl wie den folgenden aus:

cat << EOM | palmctl create cloud -f -
name: $CLOUD_TYPE
type: $CLOUD_TYPE
auto_discover: true
credentials_key: my-${CLOUD_TYPE}-cloud-secret
resource_group_id: $RESOURCE_GROUP_ID
EOM

Cloudpositionen registrieren

Registrieren Sie jede Position in jeder Cloud, die Ihre Anwendungen enthält. Die Registrierung eines Standorts ist einfacher, wenn es sich um einen der bekannten Public-Cloud-Standorte handelt. Listen Sie zuerst die öffentlichen Cloudpositionen auf, indem Sie palmctl get cloudlocations ausführen, und notieren Sie das Feld code der Cloudposition, die Ihrem Standort entspricht. Verwenden Sie anschließend diesen Code im Feld cloud_location_code , wenn Sie Ihren Standort registrieren.

Beispiel für die Registrierung einer Position, die einer vorhandenen öffentlichen Cloudposition zugeordnet ist:

cat << EOM | palmctl create location --cloud-name AWS -f -
name: AWS-east
cloud_location_code: abcdef
is_multi_zone: true
EOM

Wenn Sie eine Position registrieren, die keiner vorhandenen Public-Cloud-Position (in der Regel einem lokalen Rechenzentrum) zugeordnet ist, geben Sie zusätzliche Felder an.

Beispiel für die Registrierung einer Position, die keiner vorhandenen öffentlichen Cloudposition zugeordnet ist:

cat << EOM | palmctl create location --cloud-name OnPrem -f -
name: Factory-CA
type: region
is_multi_zone: false
city: Los Angeles
region: California
country: United States
geo_coordinates: -118.4068,34.1139
EOM
Hinweise:
  • Gültige Werte für das Feld type sind site, regionund zone.
  • Die Koordinaten im Feld geo_coordinates werden als Längengrad und dann als Breitengrad ausgedrückt.

VPCs registrieren

Registrieren Sie jede VPC, die Ihre Anwendungen enthält. Eine VPC kann eine Bereitstellungsumgebung selbst (z. B. Anwendungen auf virtuellen Maschinen (VMs) in der VPC) oder nur ein Container für Kubernetes -Cluster sein. In beiden Fällen sollte sie registriert werden. Verwenden Sie das Feld infra_only , um zwischen den beiden Fällen zu unterscheiden. Zum Beispiel:

cat << EOM | palmctl create securitygroup --cloud-name AWS --vpc-name 'myvpc' -f -
name: security group 1
EOM

Kubernetes -Cluster registrieren

Registrieren Sie jeden Cluster, auf dem Ihre Anwendungen ausgeführt werden. Wenn api_end_point, credentials_keyund auto_discover: true angegeben sind, erkennt Mesh automatisch die Namensbereiche und Anwendungen, die im Cluster ausgeführt werden. Zum Beispiel:

cat << EOM | palmctl create cluster --cloud-name AWS -f -
name: myEKS
location_id: <resource_id from previous command>
type: EKS
is_multi_zone: true
api_end_point: https://mycloud.com/cluster1
credentials_key: /path/to/key/in/SM
auto_discover: true
EOM
Wichtig : Der Name des Clusters, den Sie in Mesh erstellen, muss mit dem Namen des Clusters übereinstimmen, den Sie in IBM Cloud® oder AWS bereitgestellt haben.

Clusternamensbereiche registrieren

Wenn Sie die automatische Erkennung beim Registrieren der Cluster nicht konfiguriert haben, registrieren Sie jeden Namensbereich in den Clustern, in dem Ihre Anwendungen ausgeführt werden. Zum Beispiel:

cat << EOM | palmctl create namespace --cloud-name AWS --cluster-name myEKS -f -
name: namespace 1
EOM

Knoten registrieren

Für VMs, die Ihre Anwendungen ausführen und sich außerhalb einer VPC befinden, registrieren Sie eine Knotenressource für sie. Zum Beispiel:

cat << EOM | palmctl create node --cloud-name AWS -f -
name: myVM
location_id: <resource_id from previous command>
type: VM
EOM

Zugriff auf die Hilfe für palmctl-Befehle

Verwenden Sie die folgenden Befehle, um Hilfeinformationen zu erhalten, wenn Sie Ihre Infrastrukturressourcen anzeigen, ändern oder löschen:

palmctl get -h
palmctl update -h
palmctl delete -h