Creare servizi di mappatura delle porte
Questa pagina descrive come i producer di servizi possono pubblicare servizi che utilizzano la mappatura delle porte Private Service Connect.
La mappatura delle porte Private Service Connect consente ai client consumer di comunicare privatamente con porte di servizio specifiche su VM producer specifiche tramite un singolo endpoint Private Service Connect.
Prima di iniziare
- Devi abilitare l'API Compute Engine nel tuo progetto.
- Devi creare VM per ognuno degli endpoint di rete che vuoi collegare al NEG di mappatura delle porte. Tutte le VM devono trovarsi nella stessa regione.
- Leggi Informazioni sui servizi pubblicati.
- Leggi Informazioni sulla mappatura delle porte Private Service Connect.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per prepararti a pubblicare un servizio con la mappatura delle porte Private Service Connect, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto producer:
- Compute Load Balancer Admin (
roles/compute.loadBalancerAdmin) - Compute Network Admin (
roles/compute.networkAdmin)
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Creare e pubblicare un servizio di mappatura delle porte
I servizi di mappatura delle porte hanno configurazioni simili ai bilanciatori del carico di rete passthrough interni, ma il traffico non è bilanciato. Per creare e pubblicare un servizio di mappatura delle porte:
- Crea un NEG di mappatura delle porte
- Aggiungi endpoint di rete al NEG di mappatura delle porte
- Crea un servizio di mappatura delle porte
- Pubblica il servizio di mappatura delle porte
Creare un NEG di mappatura delle porte
Un NEG di rete di mappatura delle porte
è un NEG regionale con il tipo di endpoint di rete GCE_VM_IP_PORTMAP. Non è possibile modificare il tipo di NEG di mappatura delle porte dopo la creazione.
Quando crei un NEG di mappatura delle porte, scegli una subnet. Gli endpoint di rete associati al NEG di mappatura delle porte devono avere un'interfaccia di rete principale in questa subnet.
Console
Nella Cloud de Confiance console, vai alla pagina Gruppi di endpoint di rete.
Fai clic su Crea gruppo di endpoint di rete.
Inserisci un Nome.
Fai clic su Tipo di gruppo di endpoint di rete e seleziona NEG di mappatura delle porte (regionale).
Seleziona una Regione.
Seleziona una Rete.
Seleziona una Subnet.
Fai clic su Crea.
gcloud
Utilizza il comando network-endpoints-groups create.
gcloud compute network-endpoint-groups create NEG \
--region=REGION \
--network=NETWORK \
--subnet=SUBNET \
--network-endpoint-type=GCE_VM_IP_PORTMAP
Sostituisci quanto segue:
NEG: il nome del NEG di mappatura delle porteREGION: la regione del NEG di mappatura delle porteNETWORK: la rete VPC del NEG di mappatura delle porteSUBNET: la subnet del NEG di mappatura delle porte
API
Invia una richiesta POST al
regionNetworkEndpointGroups.insert metodo.
POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/networkEndpointGroups
{
"name": "NEG",
"networkEndpointType": "GCE_VM_IP_PORTMAP",
"network": "projects/PROJECT_ID/global/networks/NETWORK",
"subnetwork": "projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET"
}
Sostituisci quanto segue:
PROJECT_ID: l'ID progetto del NEG di mappatura delle porteREGION: la regione del NEG di mappatura delle porteNEG: il nome del NEG di mappatura delle porteNETWORK: la rete VPC del NEG di mappatura delle porteSUBNET: la subnet del NEG di mappatura delle porte
Aggiungere endpoint di rete al NEG di mappatura delle porte
Crea uno o più endpoint di rete con mappature delle porte e collegali al NEG di mappatura delle porte.
Gli endpoint di rete per i NEG di mappatura delle porte sono zonali e devono soddisfare i seguenti requisiti:
- Ogni endpoint di rete fa riferimento a una VM Compute Engine che ha un'interfaccia di rete principale nella stessa subnet del NEG di mappatura delle porte.
- Ogni endpoint di rete fa riferimento a una porta di destinazione client univoca.
Ogni endpoint di rete deve fare riferimento a una combinazione univoca di porta di servizio e VM.
Console
Nella Cloud de Confiance console, vai alla pagina Gruppi di endpoint di rete.
Fai clic sul nome del NEG di mappatura delle porte che vuoi aggiornare.
Fai clic su Aggiungi endpoint di rete.
Fai clic su Istanza VM e seleziona una VM.
Fai clic su Porta VM 1 e inserisci una porta di servizio.
Fai clic su Porta client 1 e inserisci una porta di destinazione client.
Per ogni endpoint di rete aggiuntivo che vuoi aggiungere, fai clic Aggiungi endpoint di rete e inserisci i dettagli dell'endpoint di rete.
Fai clic su Crea.
gcloud
Utilizza il
network-endpoint-groups update comando. Includi un flag --add-endpoint per ogni endpoint di rete che vuoi collegare.
gcloud compute network-endpoint-groups update NEG \
--region=REGION \
--add-endpoint=client-destination-port=CLIENT_DESTINATION_PORT_1,instance=projects/PROJECT_ID/zones/ZONE_1/instances/VM_1_NAME,port=VM_1_PORT \
--add-endpoint=client-destination-port=CLIENT_DESTINATION_PORT_2,instance=projects/PROJECT_ID/zones/ZONE_2/instances/VM_2_NAME,port=VM_2_PORT
Sostituisci quanto segue:
NEG: il nome del NEG di mappatura delle porteREGION: la regione del NEG di mappatura delle porteCLIENT_DESTINATION_PORT_1: la porta di destinazione client del primo endpoint di retePROJECT_ID: l'ID progetto del progetto producerZONE_1: la zona del primo endpoint di reteVM_1_NAME: il nome della VM di destinazione per il primo endpoint di reteVM_1_PORT: la porta di servizio del primo endpoint di reteCLIENT_DESTINATION_PORT_2: la porta di destinazione client del secondo endpoint di reteZONE_2: la zona del secondo endpoint di reteVM_2_NAME: il nome della VM di destinazione per il secondo endpoint di reteVM_2_PORT: la porta di servizio del secondo endpoint di rete
API
Invia una richiesta POST al
regionNetworkEndpointGroups.attachNetworkEndpoints metodo.
POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/networkEndpointGroups/NEG/attachNetworkEndpoints
{
"networkEndpoints": [
{
"clientDestinationPort":CLIENT_DESTINATION_PORT_1,
"instance": "projects/PROJECT_ID/zones/ZONE_1/instances/VM_1_NAME",
"port": SERVICE_PORT_1
},
{
"clientDestinationPort": CLIENT_DESTINATION_PORT_2,
"instance": "projects/PROJECT_ID/zones/ZONE_2/instances/VM_2_NAME",
"port": SERVICE_PORT_2
}
]
}
Sostituisci quanto segue:
PROJECT_ID: l'ID progetto del progetto producerREGION: la regione del NEG di mappatura delle porteNEG: il nome del NEG di mappatura delle porteCLIENT_DESTINATION_PORT_1: la porta di destinazione client del primo endpoint di reteZONE_1: la zona del primo endpoint di reteVM_1_NAME: il nome della VM di destinazione per il primo endpoint di reteSERVICE_PORT_1: la porta di servizio del primo endpoint di reteCLIENT_DESTINATION_PORT_2: la porta di destinazione client del secondo endpoint di reteZONE_2: la zona del secondo endpoint di reteVM_2_NAME: il nome della VM di destinazione per il secondo endpoint di reteSERVICE_PORT_2: la porta di servizio del secondo endpoint di rete
Creare un servizio di mappatura delle porte
Per creare un servizio di mappatura delle porte, completa i seguenti passaggi.
Non puoi modificare il NEG di mappatura delle porte associato a un servizio di backend dopo aver aggiunto il NEG. Tuttavia, puoi aggiornare gli endpoint di rete del NEG di mappatura delle porte.
Non puoi aggiornare la connessione di una regola di forwarding dopo la creazione. Se devi connetterti a un altro servizio di backend, elimina la regola di forwarding, e creane una nuova.
Console
Avvia la configurazione
Nella console Cloud de Confiance , vai alla pagina Bilanciamento del carico.
- Fai clic su Crea bilanciatore del carico.
- In Tipo di bilanciatore del carico, seleziona Bilanciatore del carico di rete (TCP/UDP/SSL) e fai clic su Avanti.
- Per Proxy o passthrough, seleziona Bilanciatore del carico passthrough e fai clic su Avanti.
- In Pubblico o interno, seleziona Interno e fai clic su Avanti.
- Fai clic su Configura.
Configurazione di base
- Inserisci un Nome bilanciatore del carico.
- Seleziona una Regione.
- Seleziona una Rete.
Configurazione backend
- In Tipo di backend, seleziona Gruppo di endpoint di rete con mappatura delle porte.
- Seleziona un Gruppo di endpoint di rete con mappatura delle porte.
Configurazione frontend
- Fai clic su Configurazione frontend.
- (Facoltativo) Inserisci un Nome.
- (Facoltativo) Inserisci una Descrizione.
- Seleziona un Protocollo.
- Seleziona una Subnet.
- Fai clic su Fine.
- Fai clic su Crea.
gcloud
Per creare un servizio di backend, utilizza il
backend-services createcomando.gcloud compute backend-services create SERVICE \ --load-balancing-scheme=internal \ --region=REGION \ --network=NETWORKSostituisci quanto segue:
SERVICE: il nome del servizio di backendREGION: la regione del servizio di backendNETWORK: la rete VPC producer del servizio di backend
Per aggiungere il NEG di mappatura delle porte al servizio di backend, utilizza il
backend-services add-backendcomando.Non puoi aggiungere più NEG di mappatura delle porte a un singolo servizio di backend.
gcloud compute backend-services add-backend SERVICE \ --network-endpoint-group=NEG \ --network-endpoint-group-region=REGIONSostituisci
NEGcon il nome del NEG di mappatura delle porte.Per creare una regola di forwarding per il servizio di mappatura delle porte, utilizza il
forwarding-rules createcomando.La regola di forwarding deve essere configurata per inoltrare il traffico per tutte le porte di destinazione client.
gcloud compute forwarding-rules create RULE \ --load-balancing-scheme=INTERNAL \ --ip-protocol=PROTOCOL \ --network=NETWORK \ --subnet=SUBNET \ --address=IP_ADDRESS \ --ports=ALL \ --region=REGION \ --backend-service=SERVICESostituisci quanto segue:
RULE: il nome della regola di forwardingPROTOCOL: il protocollo della regola di forwarding, che può essereTCPoUDPSUBNET: la subnet producer, che deve essere la stessa subnet associata al NEG di mappatura delle porteIP_ADDRESS: l'indirizzo IP della regola di forwarding, che deve provenire dall'intervallo di indirizzi IP della subnet producer
API
Per creare un servizio di backend, invia una
POSTrichiesta alregionBackendServices.insertmetodo.POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/backendServices { "name": "SERVICE", "loadBalancingScheme": "INTERNAL", "network": "projects/PROJECT_ID/global/networks/NETWORK" }Sostituisci quanto segue:
PROJECT_ID: l'ID del progetto del servizio di backendREGION: la regione del servizio di backendSERVICE: il nome del servizio di backendNETWORK: la rete VPC producer
Per aggiungere il NEG di mappatura delle porte al servizio di backend, invia una
PATCHrichiesta alregionBackendServices.patchmetodo.Non puoi aggiungere più NEG di mappatura delle porte a un singolo servizio di backend.
PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/backendServices/SERVICE { "backends": [ { "group": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/networkEndpointGroups/NEG" } ] }Sostituisci
NEGcon il nome del NEG di mappatura delle porte.Per creare una regola di forwarding per il servizio di mappatura delle porte, invia una
POSTrichiesta alforwardingRules.insertmetodo.La regola di forwarding deve essere configurata per inoltrare il traffico per tutte le porte di destinazione client.
POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/forwardingRules { "name": "RULE", "loadBalancingScheme": "INTERNAL", "IPProtocol": "PROTOCOL", "network": "projects/PROJECT_ID/global/networks/NETWORK", "subnetwork": "projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET", "IPAddress": "IP_ADDRESS", "allPorts": true, "backendService": "projects/PROJECT_ID/regions/REGION/backendServices/SERVICE" }Sostituisci quanto segue:
RULE: il nome della regola di forwardingPROTOCOL: il protocollo della regola di forwarding, che può essereTCPoUDPSUBNET: la subnet producer, che deve essere la stessa subnet associata al NEG di mappatura delle porteIP_ADDRESS: l'indirizzo IP della regola di forwarding, che deve provenire dall'intervallo di indirizzi IP della subnet producer
Pubblicare il servizio di mappatura delle porte
Per rendere disponibile il servizio di mappatura delle porte ai consumer, pubblica il servizio creando un collegamento di servizio. Quando crei il collegamento di servizio, specifica la regola di forwarding associata al servizio di mappatura delle porte.