IP-Adressen aktivieren

In diesem Dokument wird beschrieben, wie Sie IP-Adressen auf einer VM-Instanz in Google Distributed Cloud (GDC) mit Air Gap konfigurieren.

Sie können jede VM-Instanz so konfigurieren, dass sie entweder über das externe Netzwerk oder über eine andere Organisation erreichbar ist. Dies wird als VM-Ingress bezeichnet. Eine VM-Arbeitslast in einem Organisationsprojekt kann entweder das externe Netzwerk oder die aktuelle VM erreichen, die für Dienste in anderen Organisationen freigegeben ist. Dies wird als VM-Egress bezeichnet.

Sie können den ein- und ausgehenden Traffic von VMs mit einem der folgenden Ansätze steuern:

  • Externer Load Balancer und Cloud NAT-Gateway (bevorzugt): Erstellen Sie einen externen Load Balancer (ELB) für eingehenden Traffic und erstellen Sie ein Cloud NAT-Gateway für ausgehenden Traffic.
  • VirtualMachineExternalAccess (VMEA): Steuern Sie den eingehenden und ausgehenden Traffic von VMs gemeinsam über die Distributed Cloud VMM API oder die Distributed Cloud CLI. In Distributed Cloud wird die Konfiguration von VMEA über die GDC Console eingestellt und VMEA ist nicht mehr die bevorzugte Option. Sie können die eingehenden und ausgehenden IP-Adressen, die Sie für eine VM-Instanz aktiviert haben, weiterhin über die Distributed Cloud VMM API oder die GDC-Konsole aufrufen.

Dieses Dokument richtet sich an Entwickler in Plattformadministrator- oder Anwendungsoperatorgruppen, die IP-Adressen für VMs in einer Distributed Cloud-Umgebung konfigurieren. Weitere Informationen finden Sie unter Zielgruppen für die Dokumentation zu GDC mit Air Gap.

Hinweis

Wenn Sie gdcloud-Befehlszeilenbefehle verwenden möchten, müssen Sie die gdcloud-Befehlszeile heruntergeladen, installiert und konfiguriert haben. Alle Befehle für Distributed Cloud verwenden die gdcloud- oder kubectl-Befehlszeile und erfordern eine Betriebssystemumgebung.

Pfad der kubeconfig-Datei abrufen

Wenn Sie Befehle auf dem Management API-Server ausführen möchten, benötigen Sie die folgenden Ressourcen:

  1. Melden Sie sich an und generieren Sie die kubeconfig-Datei für den Management API-Server, falls Sie noch keine haben.

  2. Verwenden Sie den Pfad zur kubeconfig-Datei des Management API-Servers, um MANAGEMENT_API_SERVER in dieser Anleitung zu ersetzen.

IAM-Rollen anfordern

Bitten Sie Ihren IAM-Projektadministrator, Ihnen die folgenden Rollen für Ihr Projekt zuzuweisen:

  • Virtual Machine Project Admin (project-vm-admin): VMs im Projekt-Namespace erstellen, ändern, auflisten und löschen.

  • Project Viewer(project-viewer): Kann alle Ressourcen in den Projekt-Namespaces aufrufen.

Alle VM-Rollen müssen an den Namespace des Projekts gebunden sein, in dem sich die VM befindet. Folgen Sie der Anleitung, um Ihren Zugriff zu bestätigen.

VirtualMachineExternalAccess (VMEA) konfigurieren

VirtualMachineExternalAccess (VMEA) ist ein Mechanismus zur Steuerung des eingehenden und ausgehenden VM-Traffics. VMEA kann eingehenden und ausgehenden VM-Traffic nicht separat steuern. Der eingehende und ausgehende Traffic einer VM muss gleichzeitig aktiviert oder deaktiviert werden.

Sie können VMEA entweder über die Benutzeroberfläche oder über die Distributed Cloud VMM API konfigurieren und steuern. Eine VM kann nur eine einzige VMEA haben. Wenn eine VM keine VMEA hat, sind sowohl eingehender als auch ausgehender Traffic standardmäßig deaktiviert.

Externen Zugriff aktivieren

Wenn Sie eine VM mit externem Zugriff für die eingehende und ausgehende Datenübertragung aktivieren möchten, können Sie die VMEA über die GDC-Konsole oder die Virtual Machine Manager API von Distributed Cloud konfigurieren.

Standardmäßig ist der projektinterne Netzwerkverkehr zulässig und Sie können direkt auf Ihre VM im Projekt zugreifen. Eine Netzwerkrichtlinie blockiert den gesamten eingehenden Traffic zur VM von außerhalb des Projekts. Sie müssen manuell eine neue Netzwerkrichtlinie erstellen, damit Ihre Quell-IP-Adresse über die eingehende Datenübertragung auf die VM zugreifen kann. Diese Netzwerkrichtlinie kann entweder eine Netzwerkrichtlinie für projektübergreifenden Traffic oder eine Netzwerkrichtlinie für organisationsübergreifenden Traffic sein. Der Standort hängt davon ab, von wo aus Sie auf die VM zugreifen möchten.

Sie können den externen Zugriff einer VM aktivieren und deaktivieren, indem Sie true oder false im Feld enabled der VMEA-Spezifikation angeben. Für VM Ingress können Sie die Datenübertragung in Ports konfigurieren, indem Sie den Namen, das Protokoll und die Portnummer für jeden Port angeben, den Sie im Feld ports der VMEA-Spezifikation hinzufügen möchten.

So ermöglichen Sie den externen Zugriff auf eine VM, indem Sie eine neue VMEA erstellen:

gdcloud

Verwenden Sie den Befehl gdcloud compute mit dem Flag --enable-external-access, um den externen Zugriff auf eine VM-Instanz zu aktivieren:

gdcloud compute instances create VM_NAME \
  --project PROJECT \
  --machine-type MACHINE_TYPE \
  --image IMAGE \
  --image-project IMAGE_PROJECT \
  --enable-external-access

Ersetzen Sie Folgendes:

  • VM_NAME: der Name der VM.
  • PROJECT: das Distributed Cloud-Projekt, in dem sich die VM befindet.
  • MACHINE_TYPE: der Name des vordefinierten Maschinentyps für die VM-Instanz.
  • IMAGE: der Name des Boot-Images für die Instanz.
  • IMAGE_PROJECT: das Projekt des Boot-Images für die Instanz.

API

Führen Sie dazu diesen Befehl aus:

kubectl --kubeconfig MANAGEMENT_API_SERVER \
  apply -n PROJECT -f - <<EOF
apiVersion: virtualmachine.gdc.goog/v1
kind: VirtualMachineExternalAccess
metadata:
  name: VM_NAME
spec:
  enabled: true
  ports:
  - name: PORT_NAME
    protocol: PROTOCOL
    port: PORT_NUMBER
EOF

Ersetzen Sie Folgendes:

  • MANAGEMENT_API_SERVER: die kubeconfig-Datei für den Management API-Server.
  • PROJECT: das Distributed Cloud-Projekt, in dem sich die VM befindet.
  • VM_NAME ist der Name Ihrer VM.
  • PORT_NAME: der Portname.
  • PROTOCOL: das Protokoll, das der Ingress-Dienst verwenden soll. Der Protokollname muss großgeschrieben werden und ein von Kubernetes unterstütztes Protokoll sein, z. B. TCP, UDP oder SCTP.
  • PORT_NUMBER: die Portnummer.

Führen Sie den folgenden Befehl aus, um den externen Zugriff auf eine VM zu aktivieren, indem Sie eine vorhandene VMEA über die VMM API bearbeiten:

kubectl --kubeconfig MANAGEMENT_API_SERVER \
  -n PROJECT \
  edit virtualmachineexternalaccesses.virtualmachine.gdc.goog VM_NAME

Externen Zugriff deaktivieren

Wenn eine VM keine entsprechende VMEA hat, sind sowohl eingehender als auch ausgehender Traffic deaktiviert. Wenn eine VM einen entsprechenden VMEA hat, können Sie den VMEA deaktivieren, indem Sie entweder das Feld enabled auf false setzen oder den VMEA direkt löschen. Diese Vorgänge können Sie über die Distributed Cloud VMM API ausführen.

So deaktivieren Sie den externen Zugriff:

API

Deaktivieren Sie den externen Zugriff, indem Sie eine VMEA löschen:

kubectl --kubeconfig MANAGEMENT_API_SERVER \
  -n PROJECT \
  delete virtualmachineexternalaccesses.virtualmachine.gdc.goog VM_NAME

Ersetzen Sie Folgendes:

  • MANAGEMENT_API_SERVER: die kubeconfig-Datei für den Management API-Server
  • VM_NAME: der Name der VM
  • PROJECT: das Distributed Cloud-Projekt, in dem sich die VM befindet

So deaktivieren Sie den externen Zugriff, indem Sie eine VMEA bearbeiten:

kubectl --kubeconfig MANAGEMENT_API_SERVER \
  -n PROJECT \
  edit virtualmachineexternalaccesses.virtualmachine.gdc.goog VM_NAME

Aktualisieren Sie das Feld enabled auf false.

Eingehender Traffic

Ingress-IP-Adressen ansehen

Wenn für eine VM Ingress aktiviert ist, wird nach dem Erstellen eine Ingress-IP-Adresse in der GDC-Konsole angezeigt. Sie finden diese Ingress-IP-Adresse auch auf der Seite VM-Details in der GDC Console.

Verwenden Sie die Distributed Cloud VMM API, um die IP-Adresse abzurufen. Führen Sie Folgendes aus:

API

Rufen Sie die IP-Adresse ab:

kubectl --kubeconfig MANAGEMENT_API_SERVER \
  -n PROJECT \
  get virtualmachineexternalaccesses.virtualmachine.gdc.goog VM_NAME \
  -ojsonpath='{.status.ingressIP}'

Verwenden Sie für eine VM mit einem anderen Betriebssystem den Befehl ssh, um die VM mit der Ingress-IP-Adresse und dem Port aufzurufen, den Sie mit TCP aktiviert haben.

Ingress bearbeiten

Nachdem Sie VMEA für eine VM aktiviert haben, können Sie den eingehenden Traffic anpassen, indem Sie die VMEA bearbeiten. Sie können die Spezifikation des VM-Ingress direkt in der GDC-Konsole bearbeiten. Sie können auch die kubectl-Befehlszeile verwenden, um den VM-Ingress aus der Spezifikation der VMEA zu bearbeiten.

So bearbeiten Sie die VMEA, um den Ingress anzupassen:

Verwenden Sie beispielsweise die folgenden Befehle, um den Port PORT_NUMBER für eingehenden Traffic einer vorhandenen VM über das TCP-Protokoll hinzuzufügen:

Console

Bearbeiten Sie die Ports des VM-Ingress-Dienstes direkt in der GDC-Konsole:

  1. Klicken Sie im vertikalen Navigationsmenü auf Instanzen.
  2. Scrollen Sie auf der Seite zu Netzwerkdetails.
  3. Klicken Sie unter Eingehende Ports auf das Bearbeitungssymbol, um den eingehenden Port zu bearbeiten.

    Console-Benutzeroberfläche mit der Liste der Netzwerkdetails und dem Bearbeitungssymbol für eingehende Ports

API

kubectl --kubeconfig MANAGEMENT_API_SERVER \
  -n PROJECT \
  patch virtualmachineexternalaccesses.virtualmachine.gdc.goog VM_NAME \
  --type "json" -p '[{"op":"add","path":"/spec/ports/-","value": {"name":"PORT_NAME","port":PORT_NUMBER, "Protocol":"TCP"}}]'

Ersetzen Sie Folgendes:

  • MANAGEMENT_API_SERVER: die kubeconfig-Datei für den Management API-Server
  • VM_NAME: der Name der VM
  • PROJECT: das Distributed Cloud-Projekt, in dem sich die VM befindet
  • PORT_NAME: der Name des Ports, der hinzugefügt werden soll
  • PORT_NUMBER: die Portnummer

Ingress mit Nicht-TCP-Protokoll aktivieren

Mit Distributed Cloud können Sie VM-Ingress mit verschiedenen Protokollen aktivieren. Standardmäßig verwendet ein VM-Ingress-Dienst das TCP-Protokoll. Sie können für Ihre VM einen eigenen eingehenden Traffic für Nicht-TCP-Protokolle hinzufügen. Distributed Cloud unterstützt die folgenden Protokolle:

  • Transmission Control Protocol (TCP).
  • User Datagram Protocol (UDP).
  • Stream Control Transmission Protocol (SCTP).

Sie können die Datenübertragung mit einem Nicht-TCP-Protokoll aktivieren, indem Sie beim Erstellen von VMEA verschiedene Protokollnamen angeben.

Ausgehender Traffic

Eine VM-Arbeitslast in einem Organisationsprojekt kann das externe Netzwerk erreichen oder für Dienste in anderen Organisationen freigegeben werden. Wenn Sie die ausgehende Datenübertragung für die VM aktivieren, wird eine IP-Adresse für ausgehenden Traffic generiert. Die VM stellt über diese IP-Adresse eine Verbindung zu den externen Diensten her.

Damit diese IP-Adresse Daten aus dem externen Netzwerk übertragen kann, müssen Sie möglicherweise projektbezogene Netzwerkrichtlinien anwenden. Weitere Informationen finden Sie unter Netzwerkrichtlinie für organisationsübergreifenden ausgehenden Traffic.

Wenn eine VM für ausgehenden Traffic über ein Cloud NAT-Gateway konfiguriert ist, muss die folgende Annotation dem Objekt für den externen Zugriff auf die VM hinzugefügt werden, um die ausgehende Verbindung beizubehalten: egress.networking.gke.io/use-cloud-nat:"true"

IP-Adresse für ausgehenden Traffic ansehen

Wenn für eine VM ausgehender Traffic aktiviert ist, wird nach der Erstellung in der GDC-Konsole eine IP-Adresse für ausgehenden Traffic angezeigt. Sie finden diese IP-Adresse für ausgehenden Traffic auch auf der Seite VM-Details.

So rufen Sie die ausgehende IP-Adresse auf:

API

Rufen Sie die IP-Adresse ab:

kubectl --kubeconfig MANAGEMENT_API_SERVER \
  -n PROJECT \
  get virtualmachineexternalaccesses.virtualmachine.gdc.goog VM_NAME \
  -ojsonpath='{.status.egressIP}'

Ersetzen Sie Folgendes:

  • MANAGEMENT_API_SERVER: die kubeconfig-Datei für den Management API-Server
  • VM_NAME: der Name der VM
  • PROJECT: das Distributed Cloud-Projekt, in dem sich die VM befindet

Ausgehender VM-Traffic basiert auf einem Projekt. VMs im selben Projekt haben dieselbe ausgehende IP-Adresse.

Ausgehenden Traffic steuern

In früheren Distributed Cloud-Versionen mussten Sie die VM neu starten, damit Änderungen am ausgehenden Traffic auf einer laufenden VM wirksam wurden. In Version 1.11 können Sie den ausgehenden VM-Traffic aktivieren und deaktivieren, ohne die VM neu zu starten. Diese Änderung wird sofort nach der Aktualisierung des VMEA wirksam.