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.
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 cloudausgeführt haben, notieren Sie den Wert des Feldesresource_idin der Ausgabe. Setzen Sie den Wert der Shell-VariablenRESOURCE_GROUP_IDauf den Wertresource_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
namekann beliebig sein, solange er eindeutig ist. - Die gültigen Werte für
typesind:IBM,AWS,GCP,Azure, undother.Hinweis: Sie können die automatische Erkennung nicht auf Wolken des Typsotherausführen. - Legen Sie die folgenden Werte fest, um alle Ihre vor Ort befindlichen Rechenzentren darzustellen:
- Setzen Sie
typeaufother. - Setzen Sie
is_privateauftrue.
- Setzen Sie
- Es wird keine Ressourcengruppen-ID angegeben, so dass die gefundenen Ressourcen in
Default_Infrastructure_Groupplatziert 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
- Gültige Werte für das Feld
typesindsite,regionundzone. - Die Koordinaten im Feld
geo_coordinateswerden 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
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