Esegui il provisioning di un'organizzazione di valutazione senza peering VPC

Questa pagina si applica a Apigee, ma non a Apigee ibrido.

Visualizza documentazione di Apigee Edge.

Questo documento spiega come installare e configurare un'organizzazione di valutazione Apigee dalla riga di comando senza Peering VPC. Le organizzazioni di valutazione scadono dopo 60 giorni e potrebbero avere altre limitazioni. Vedi anche Confronto tra organizzazioni di valutazione e quelle a pagamento.

Limitazioni

L'opzione di installazione tramite peering non VPC descritta in questo documento presenta alcune limitazioni:

Per un elenco completo delle funzionalità e degli approcci al networking che sono e non sono supportati per il peering non VPC, vedi Come scegliere un'opzione di networking.

Riepilogo dei passaggi

Ecco la procedura di provisioning:

Passaggio 1: definizione delle variabili di ambiente

Configura gcloud e definisci le variabili di ambiente da utilizzare nei passaggi successivi:

  1. Assicurati di aver soddisfatto i requisiti elencati nella sezione Prerequisiti.
  2. Devi avere installato gcloud CLI. Se è necessario installarlo, vedi Installa gcloud CLI.
  3. Inizializza gcloud CLI, come descritto in Inizializzare l'interfaccia a riga di comando gcloud oppure, se l'interfaccia a riga di comando è già inizializzata, assicurati che Il progetto Google Cloud che hai creato in Prerequisiti è il progetto predefinito per gcloud.
  4. Definisci le seguenti variabili di ambiente:
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
    PROJECT_ID="YOUR_PROJECT_ID"
    RUNTIME_LOCATION="YOUR_RUNTIME_LOCATION"
    ANALYTICS_REGION="YOUR_ANALYTICS_REGION"

    Dove:

    • AUTH definisce l'intestazione Authentication con un token di connessione. Tu userà questa intestazione durante la chiamata alle API Apigee. Tieni presente che il token scade dopo il giorno un periodo di tempo e quando succede, puoi semplicemente rigenerarlo utilizzando lo stesso comando. Per Per ulteriori informazioni, consulta la pagina di riferimento per il comando Print-access-token.
    • PROJECT_ID è l'ID progetto Cloud che hai creato nell'ambito della Prerequisiti.
    • RUNTIME_LOCATION è la posizione fisica in cui Apigee in esecuzione. Per un elenco delle località di runtime disponibili, consulta Località Apigee.

    • ANALYTICS_REGION è la località fisica in cui Apigee i dati di analisi saranno archiviati. Per un elenco di regioni disponibili per l'analisi delle API Apigee, consulta Località Apigee.

      Sia RUNTIME_LOCATION che ANALYTICS_REGION possono essere la stessa regione, ma non devono essere necessariamente uguali. Tuttavia, potrebbe esserci un vantaggio in termini di prestazioni se sono uguali.

  5. (Facoltativo) Controlla il tuo lavoro richiamando i valori che hai appena impostato. Tieni presente che quando vuoi per utilizzare una variabile nei tuoi comandi, fai precedere il nome della variabile dal simbolo del dollaro ($).
    echo $AUTH
    echo $PROJECT_ID
    echo $RUNTIME_LOCATION
    echo $ANALYTICS_REGION
    

    Le risposte ai tuoi comandi echo dovrebbero avere il seguente aspetto:

    Authorization: Bearer ya29.a123456678940B63hPSAMPLEsampleKKYVsample0f3pWDWZDuH2-hENkNa
    TvgZ1PD977TMvv6edBQPJezdHw040880Ol_LoD5ZDkt-i-knizia_KhA9L20sSvztL81-SAMPLE42ELPMASk2_
    1CxN
    my-cloud-project
    us-west1
    us-west1
    

Passaggio 2: attivazione delle API

  1. Apigee richiede l'abilitazione di diverse API Google Cloud. Per abilitarle, esegui services enable :

    gcloud services enable apigee.googleapis.com \
      cloudkms.googleapis.com --project=$PROJECT_ID
  2. (Facoltativo) Per controllare il tuo lavoro, utilizza il comando services list per mostrare tutte le API abilitate:

    gcloud services list

    La risposta mostra tutti i servizi abilitati, incluse le API che hai appena abilitato (Apigee, Cloud KMS e Compute Engine).

Passaggio 3: creazione di un'organizzazione

Un'organizzazione è il container di primo livello in Apigee. Contiene tutti i proxy API e le risorse correlate. Per maggiori dettagli, consulta la sezione Informazioni sulle organizzazioni.

  1. Crea una nuova organizzazione di valutazione con l'API ProvisionOrganization:
     suppresswarning="true">curl "https://apigee.googleapis.com/v1/projects/$PROJECT_ID:provisionOrganization"  \
      -H "$AUTH" \
      -X POST \
      -H "Content-Type:application/json" \
      -d '{
        "analyticsRegion":"'"$ANALYTICS_REGION"'",
        "runtimeLocation":"'"$RUNTIME_LOCATION"'",
        "disableVpcPeering":"true",
      }'

    Dove:

    • -d definisce il payload dei dati per la richiesta. Questo payload deve includere le seguenti:
      • ANALYTICS_REGION: specifica la località fisica in cui vengono eseguiti i tuoi dati verranno archiviati.

      • RUNTIME_LOCATION: è la località fisica in cui si trova l'istanza Apigee.

      • disableVpcPeering: In questo flusso di provisioning, non utilizzano il peering VPC, quindi questo flag deve essere impostato su true. Predefinita: false
  2. Apigee avvia un LRO per creare l'organizzazione di valutazione. Questa operazione può richiedere fino a 40 minuti completato.

  3. Per controllare lo stato della tua richiesta di creazione, puoi inviare una richiesta GET ad Apigee Elenca l'API Organization, come mostrato nell'esempio seguente:
    curl -H "$AUTH" "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID"

    Se vedi questa risposta, significa che la creazione dell'organizzazione non è ancora stata completata:

    {
    "error": {
    "code": 403,
    "message": "Permission denied on resource \"organizations/apigee-docs-m\" (or it may not exist)",
    "status": "PERMISSION_DENIED"
    }
    }

    Se l'operazione riesce, l'oggetto di risposta indica "state": "ACTIVE" e potrai andare al passaggio successivo.

Passaggio 4: configura il routing

In questo passaggio configurerai il modo in cui le applicazioni client comunicano con Apigee. Client per Apigee il traffico è anche chiamato "northbound" per via del traffico. Le opzioni di configurazione per nordest sono le seguenti:

Tipo di accesso Descrizione del processo di configurazione e deployment
Interno con PSC

Consenti solo l'accesso interno ai proxy API da qualsiasi progetto Google Cloud utilizzando Private Service Connect (PSC).

PSC consente la connessione privata tra un producer di servizi (Apigee) e un consumer di servizi (il progetto VPC in peering uno o più altri progetti Cloud sotto il tuo controllo). Con questo metodo, le richieste passare attraverso un endpoint di servizio o un bilanciatore del carico interno a livello di regione a un singolo punto di collegamento, da un collegamento a un servizio. Questa configurazione consente ai tuoi clienti interni di inviare Richieste proxy API Apigee da qualsiasi macchina abilitata in rete.

Esterno con PSC

Consenti l'accesso esterno ai proxy API utilizzando Private Service Connect (PSC).

Utilizza Private Service Connect (PSC) per abilitare la connessione privata tra un producer di servizi (Apigee) e un consumer di servizi (il progetto VPC in peering uno o più altri progetti Cloud sotto il tuo controllo). Con questo metodo, le richieste passano tramite un bilanciatore del carico esterno globale o esterno a livello di regione, un punto di collegamento, chiamato collegamento a un servizio. Questa configurazione ti consente di inviare Richieste proxy API Apigee da qualsiasi di un computer abilitato per la rete.

Ciascuno di questi approcci al routing viene presentato in una scheda delle istruzioni riportate di seguito.

Routing interno (PSC)

Questa sezione spiega come consentire solo l'accesso interno ai proxy API da uno qualsiasi dei Progetti Google Cloud che utilizzano Private Service Connect (PSC).

Per configurare l'accesso interno con PSC hai a disposizione le seguenti opzioni:

Seleziona la scheda di seguito per la tua scelta di configurazione e segui i passaggi:

Endpoint di servizio

Crea un endpoint di servizio PSC per il collegamento al servizio

  1. Recupera il collegamento al servizio dall'istanza Apigee:
    curl -i -X GET -H "$AUTH" \
      "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/instances"

    Nel seguente output di esempio, il valore serviceAttachment è mostrato in grassetto:

    {
      "instances": [
        {
          "name": "us-west1",
          "location": "us-west1",
          "createdAt": "1645731488019",
          "lastModifiedAt": "1646504754219",
          "diskEncryptionKeyName": "projects/my-project/locations/us-west1/keyRings/us-west1/cryptoKeys/dek",
          "state": "ACTIVE",
          "runtimeVersion": "1-7-0-20220228-190814",
          "consumerAcceptList": [
            "my-project"
          ],
          "serviceAttachment": "projects/bfac74a67a320c43a12p-tp/regions/us-west1/serviceAttachments/apigee-us-west1-crw1"
        }
      ]
    }
  2. Crea un endpoint di servizio PSC che punti al collegamento del servizio ottenuto dal corpo della risposta dell'istanza nel passaggio precedente, come spiegato in Crea un endpoint Private Service Connect.
  3. Prendi nota e ricorda l'indirizzo IP dell'endpoint di servizio. Ti servirà l'indirizzo IP in un secondo momento, puoi testare la configurazione chiamando un proxy API. (Ad esempio: 10.138.0.2).

Provisioning di Apigee completato. Vai a Deployment di un proxy di esempio.

Bilanciatore del carico regionale interno

Passaggio 8a: configura le variabili di ambiente

Le istruzioni in questa sezione usano le variabili di ambiente per fare riferimento all'uso ripetuto stringhe. Assicurati di aver impostato le variabili in Definisci le variabili di ambiente.

Inoltre, imposta le seguenti variabili di ambiente:

  • Definisci le seguenti variabili di ambiente nel terminale di comando:
    NEG_NAME=YOUR_NEG_NAME"
    TARGET_SERVICE=YOUR_TARGET_SERVICE"
    NETWORK_NAME=YOUR_NETWORK_NAME"
    SUBNET_NAME=YOUR_SUBNET_NAME"

    Dove:

    • NEG_NAME: un nome per il gruppo di endpoint di rete.
    • TARGET_SERVICE: il collegamento al servizio che vuoi connettersi. Ad esempio: projects/bfac7497a40c32a12p-tp/regions/us-west1/serviceAttachments/apigee-us-west1-crw7
    • NETWORK_NAME: (facoltativo) nome della rete in cui viene creato il NEG. Se ometti parametro viene usata la rete del progetto default.
    • SUBNET_NAME: nome della subnet utilizzata per la connettività privata al producer. Le dimensioni della subnet possono essere ridotte: il NEG PSC richiede solo un IP dalla subnet. Per Apigee, è necessario un solo NEG PSC per regione. La subnet può essere condivisa e utilizzata dalle VM altre entità. Se non viene specificata una subnet, gli endpoint di rete possono appartenere a qualsiasi subnet nella regione in cui è stato creato il gruppo di endpoint di rete.
  • Passaggio 8b: crea una subnet solo proxy

    gcloud compute networks subnets create testproxyonlysubnet \
      --purpose=REGIONAL_MANAGED_PROXY --role=ACTIVE --region=$RUNTIME_REGION --network=$NETWORK_NAME \
      --range=100.0.0.0/24 --project=$PROJECT_ID

    Passaggio 8c: crea un gruppo di endpoint di rete (NEG)

    1. Recupera il collegamento al servizio dall'istanza creata in precedenza:
      curl -i -X GET -H "$AUTH" \
      "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/instances"

      Nel seguente output di esempio, il valore serviceAttachment è mostrato in grassetto:

      {
      "instances": [
        {
          "name": "us-west1",
          "location": "us-west1",
          "createdAt": "1645731488019",
          "lastModifiedAt": "1646504754219",
          "diskEncryptionKeyName": "projects/my-project/locations/us-west1/keyRings/us-west1/cryptoKeys/dek",
          "state": "ACTIVE",
          "runtimeVersion": "1-7-0-20220228-190814",
          "consumerAcceptList": [
            "my-project"
          ],
          "serviceAttachment": "projects/bfac7497a40c32a12p-tp/regions/us-west1/serviceAttachments/apigee-us-west1-crw7"
        }
      ]
      }
    2. Crea un NEG Private Service Connect che punti al servizio che hai ottenuto dal corpo della risposta dell'istanza nel passaggio precedente.

      gcloud compute network-endpoint-groups create $NEG_NAME \
      --network-endpoint-type=private-service-connect \
      --psc-target-service=$TARGET_SERVICE \
      --region=$RUNTIME_LOCATION \
      --project=$PROJECT_ID
      

    Passaggio 8d: configura il bilanciatore del carico interno a livello di regione

    1. Prenota un indirizzo IPv4 interno per il bilanciatore del carico.
      gcloud compute addresses create ADDRESS_NAME \
      --ip-version=IPV4 --subnet=$SUBNET_NAME \
        --region=$RUNTIME_LOCATION --project=$PROJECT_ID

      Sostituisci ADDRESS_NAME con un nome per la risorsa dell'indirizzo IP.

      Esegui questo comando per visualizzare l'indirizzo IP riservato:

      gcloud compute addresses describe ADDRESS_NAME \
      --format="get(address)" --region=RUNTIME_LOCATION --project=$PROJECT_ID
    2. Crea un servizio di backend per il NEG.
      gcloud compute backend-services create BACKEND_SERVICE_NAME \
      --load-balancing-scheme=INTERNAL_MANAGED \
      --protocol=HTTPS \
      --region=$RUNTIME_REGION \
      --project=$PROJECT_ID
    3. Sostituisci BACKEND_SERVICE_NAME con il nome del servizio di backend.

    4. Aggiungi il servizio di backend al NEG.
      gcloud compute backend-services add-backend BACKEND_SERVICE_NAME \
      --network-endpoint-group=NEG_NAME \
      --region=$RUNTIME_LOCATION \
      --project=$PROJECT_ID

      Sostituisci quanto segue:

      • BACKEND_SERVICE_NAME: il nome del servizio di backend.
      • NEG_NAME: il nome del gruppo di endpoint di rete.
    5. Devi disporre di una risorsa del certificato SSL da utilizzare nella Proxy HTTPS di destinazione.

      Utilizza questo comando per creare una risorsa del certificato SSL autogestito. Per creare un certificato SSL autogestito, sono necessari un file di chiave privata locale e un certificato locale . Se hai bisogno di creare questi file, consulta passaggio 1 di utilizzando certificati SSL autogestiti.

      gcloud compute ssl-certificates create CERTIFICATE \
      --certificate LB_CERT \
      --private-key LB_PRIVATE_KEY
      --region=RUNTIME_LOCATION --project=$PROJECT_ID

      Sostituisci quanto segue:

      • CERTIFICATE: un nome per il certificato.
      • LB_CERT: il percorso del file del certificato in formato PEM per il certificato autogestito.
      • LB_PRIVATE_KEY: il percorso del file della chiave privata in formato PEM per il certificato autogestito.
    6. Crea una mappa URL per il bilanciatore del carico.

      Una mappa URL deve fare riferimento a un servizio di backend predefinito. Imposta il servizio di backend che appena creato come predefinito.

      gcloud compute url-maps create URL_MAP_NAME \
          --default-service=DEFAULT_BACKEND_SERVICE_NAME \
          --global --project=$PROJECT_ID

      Sostituisci quanto segue:

      • URL_MAP_NAME: un nome per la mappa URL.
      • DEFAULT_BACKEND_SERVICE_NAME: il nome del servizio di backend predefinito del bilanciatore del carico. L'impostazione predefinita viene utilizzata quando nessuna regola host corrisponde al nome host richiesto.
    7. Utilizza la risorsa del certificato SSL per creare un proxy HTTPS di destinazione.

      gcloud compute target-https-proxies create PROXY_NAME \
      --url-map=URL_MAP_NAME \
      --ssl-certificates=CERTIFICATE \
      --region=$RUNTIME_LOCATION --project=$PROJECT_ID

      Sostituisci quanto segue:

      • PROXY_NAME: un nome per il proxy HTTPS di destinazione.
      • URL_MAP_NAME: il nome della mappa URL.
      • CERTIFICATE: il nome della risorsa del certificato.
    8. Crea la regola di forwarding.
      gcloud compute forwarding-rules create FWD_RULE \
      --load-balancing-scheme=INTERNAL_MANAGED \
      --address=ADDRESS_NAME \
      --target-https-proxy=PROXY_NAME \
      --ports=443 \
      --target-https-proxy-region=$RUNTIME_REGION \
      --region=$RUNTIME_REGION
      --project=$PROJECT_ID

      Sostituisci quanto segue:

      • FWD_RULE: un nome per la regola di forwarding.
      • ADDRESS_NAME: la risorsa dell'indirizzo IP che hai prenotato per l'utilizzo per la regola di forwarding.
      • PROXY_NAME: il nome del proxy HTTPS di destinazione.

    Provisioning di Apigee completato. Vai a Deployment di un proxy di esempio.

    Routing esterno (PSC)

    Questa sezione descrive come configurare il routing esterno utilizzando Private Service Connect (PSC) per consentono la comunicazione tra Apigee e VPC controllati da te. Devi eseguire questa operazione prima puoi inviare una richiesta da un client esterno alla tua istanza di runtime Apigee.

    Passaggio 8b: crea un NEG e configura il bilanciatore del carico

    Puoi creare un bilanciatore del carico globale o regionale.

    Bilanciatore del carico esterno globale

    Configura un account globale bilanciatore del carico HTTP(S) esterno (bilanciamento del carico) schema impostato su EXTERNAL_MANAGED).

    Sebbene il NEG Private Service Connect sia a livello di regione, tutti gli altri componenti di bilanciamento del carico in questa configurazione sono globali.

    1. Assicurati di aver impostato le variabili di ambiente in Definisci le variabili di ambiente.
    2. Recupera il collegamento al servizio dall'istanza creata in precedenza:
      curl -i -X GET -H "$AUTH" \
            "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/instances"

      Nel seguente output di esempio, il valore serviceAttachment è mostrato in grassetto:

      {
            "instances": [
              {
                "name": "us-west1",
                "location": "us-west1",
                "host": "10.82.192.2",
                "port": "443",
                "createdAt": "1645731488019",
                "lastModifiedAt": "1646504754219",
                "diskEncryptionKeyName": "projects/my-project/locations/us-west1/keyRings/us-west1/cryptoKeys/dek",
                "state": "ACTIVE",
                "peeringCidrRange": "SLASH_22",
                "runtimeVersion": "1-7-0-20220228-190814",
                "ipRange": "10.82.192.0/22,10.82.196.0/28",
                "consumerAcceptList": [
                  "875609189304"
                ],
                "serviceAttachment": "projects/bfac7497a40c32a12p-tp/regions/us-west1/serviceAttachments/apigee-us-west1-crw7"
              }
            ]
          }
    3. Crea un NEG Private Service Connect che punti al servizio che hai ottenuto dal corpo della risposta dell'istanza nel passaggio precedente.

          gcloud compute network-endpoint-groups create $NEG_NAME \
            --network-endpoint-type=private-service-connect \
            --psc-target-service=$TARGET_SERVICE \
            --region=$RUNTIME_LOCATION \
            --network=NETWORK_NAME \
            --subnet=SUBNET_NAME \
            --project=$PROJECT_ID
          

      Sostituisci quanto segue:

      • NETWORK_NAME: (facoltativo) nome della rete in cui viene creato il NEG. Se ometti parametro viene usata la rete del progetto default.
      • SUBNET_NAME: nome della subnet utilizzata per la connettività privata al producer. Le dimensioni della subnet possono essere ridotte: il NEG PSC richiede solo un IP dalla subnet. Per Apigee, è necessario un solo NEG PSC per regione. La subnet può essere condivisa e utilizzata dalle VM altre entità. Se non viene specificata una subnet, gli endpoint di rete possono appartenere a qualsiasi subnet nella regione in cui è stato creato il gruppo di endpoint di rete.
      • PROJECT_ID Il progetto Cloud già associato alla tua organizzazione Apigee o un progetto Cloud incluso nel consumerAcceptlist, quando è stata creata l'istanza di runtime Apigee.
    4. Prenota un indirizzo IPv4 esterno globale per il bilanciatore del carico.
      gcloud compute addresses create ADDRESS_NAME \
        --ip-version=IPV4 --global --project=$PROJECT_ID

      Sostituisci ADDRESS_NAME con un nome per la risorsa dell'indirizzo IP.

      Esegui questo comando per visualizzare l'indirizzo IP riservato:

      gcloud compute addresses describe ADDRESS_NAME \
        --format="get(address)" --global --project=$PROJECT_ID
    5. Crea un servizio di backend per il NEG.
      gcloud compute backend-services create BACKEND_SERVICE_NAME \
        --load-balancing-scheme=EXTERNAL_MANAGED \
        --protocol=HTTPS \
        --global --project=$PROJECT_ID
    6. Sostituisci BACKEND_SERVICE_NAME con il nome del servizio di backend.

    7. Aggiungi il servizio di backend al NEG.
      gcloud compute backend-services add-backend BACKEND_SERVICE_NAME \
        --network-endpoint-group=NEG_NAME \
        --network-endpoint-group-region=$REGION \
        --global --project=$PROJECT_ID

      Sostituisci quanto segue:

      • BACKEND_SERVICE_NAME: il nome del servizio di backend.
      • NEG_NAME: il nome del gruppo di endpoint di rete.
      • REGION: la regione del gruppo di endpoint di rete.
    8. Crea una mappa URL per il bilanciatore del carico.

      Una mappa URL deve fare riferimento a un servizio di backend predefinito. Imposta il servizio di backend che appena creato come predefinito.

      gcloud compute url-maps create URL_MAP_NAME \
        --default-service=DEFAULT_BACKEND_SERVICE_NAME \
        --global --project=$PROJECT_ID

      Sostituisci quanto segue:

      • URL_MAP_NAME: un nome per la mappa URL.
      • DEFAULT_BACKEND_SERVICE_NAME: il nome del servizio di backend predefinito del bilanciatore del carico. L'impostazione predefinita viene utilizzata quando nessuna regola host corrisponde al nome host richiesto.
    9. Crea il proxy HTTPS di destinazione.

      Devi disporre di una risorsa del certificato SSL da utilizzare nella Proxy HTTPS di destinazione. Puoi creare una risorsa del certificato SSL utilizzando un account certificato SSL o certificato SSL autogestito. L'utilizzo dei certificati gestiti da Google è l'opzione consigliata perché Google Cloud ottiene, gestisce e rinnova questi certificati automaticamente.

      Per creare un certificato gestito da Google, devi avere un dominio.

      Utilizza questo comando per creare una risorsa del certificato SSL gestito da Google:

      gcloud compute ssl-certificates create CERTIFICATE \
        --domains DOMAIN --project=$PROJECT_ID

      Sostituisci quanto segue:

      • CERTIFICATE: un nome per il certificato.
      • DOMAIN: il nome di dominio del bilanciatore del carico.

      Utilizza questo comando per creare una risorsa del certificato SSL autogestito. Per creare un certificato SSL autogestito, sono necessari un file di chiave privata locale e un certificato locale . Se devi creare questi file, consulta il passaggio 1 sull'utilizzo dei certificati SSL autogestiti.

      gcloud compute ssl-certificates create CERTIFICATE \
        --certificate LB_CERT \
        --private-key LB_PRIVATE_KEY --project=$PROJECT_ID

      Sostituisci quanto segue:

      • CERTIFICATE: un nome per il certificato.
      • LB_CERT: il percorso del file del certificato in formato PEM per il certificato autogestito.
      • LB_PRIVATE_KEY: il percorso del file della chiave privata in formato PEM per il certificato autogestito.

      Utilizza la risorsa del certificato SSL per creare un proxy HTTPS di destinazione.

      gcloud compute target-https-proxies create PROXY_NAME \
        --url-map=URL_MAP_NAME \
        --ssl-certificates=CERTIFICATE --project=$PROJECT_ID

      Sostituisci quanto segue:

      • PROXY_NAME: un nome per il proxy HTTPS di destinazione.
      • URL_MAP_NAME: il nome della mappa URL.
      • CERTIFICATE: il nome della risorsa del certificato.
    10. Crea la regola di forwarding.
      gcloud compute forwarding-rules create FWD_RULE \
        --load-balancing-scheme=EXTERNAL_MANAGED \
        --network-tier=PREMIUM \
        --address=ADDRESS_NAME \
        --target-https-proxy=PROXY_NAME \
        --ports=443 \
        --global --project=$PROJECT_ID

      Sostituisci quanto segue:

      • FWD_RULE: un nome per la regola di forwarding.
      • ADDRESS_NAME: la risorsa dell'indirizzo IP che hai prenotato per l'utilizzo per la regola di forwarding.
      • PROXY_NAME: il nome del proxy HTTPS di destinazione.

    Provisioning di Apigee completato. Vai a Deployment di un proxy di esempio.

    Bilanciatore del carico esterno regionale

    Configurare un bilanciatore del carico HTTP(S) esterno regionale. Vedi anche Panoramica dei bilanciatori del carico HTTP(S) esterni.

    1. Assicurati di aver impostato le variabili in Definisci le variabili di ambiente.
    2. Crea una subnet solo proxy:
      gcloud compute networks subnets create SUBNET_NAME \
        --purpose=REGIONAL_MANAGED_PROXY --role=ACTIVE \
        --region=$RUNTIME_LOCATION --network=NETWORK_NAME \
        --range=100.0.0.0/24 --project=$PROJECT_ID
      • Sostituisci SUBNET_NAME con il nome della subnet.
      • (Facoltativo) Sostituisci NETWORK_NAME il nome della rete in cui viene creata la subnet. Se ometti questo parametro, viene utilizzata la rete di progetto predefinita.
    3. Recupera il collegamento al servizio dall'istanza creata in precedenza:
      curl -i -X GET -H "$AUTH" \
              "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/instances"

      Nel seguente output di esempio, il valore serviceAttachment è mostrato in grassetto:

      {
              "instances": [
                {
                  "name": "us-west1",
                  "location": "us-west1",
                  "host": "10.82.192.2",
                  "port": "443",
                  "createdAt": "1645731488019",
                  "lastModifiedAt": "1646504754219",
                  "diskEncryptionKeyName": "projects/my-project/locations/us-west1/keyRings/us-west1/cryptoKeys/dek",
                  "state": "ACTIVE",
                  "peeringCidrRange": "SLASH_22",
                  "runtimeVersion": "1-7-0-20220228-190814",
                  "ipRange": "10.82.192.0/22,10.82.196.0/28",
                  "consumerAcceptList": [
                    "875609189304"
                  ],
                  "serviceAttachment": "projects/bfac7497a40c32a12p-tp/regions/us-west1/serviceAttachments/apigee-us-west1-crw7"
                }
              ]
            }
    4. Crea un gruppo di endpoint di rete.
      gcloud compute network-endpoint-groups create NEG_NAME \
              --network-endpoint-type=private-service-connect \
              --psc-target-service=TARGET_SERVICE \
              --region=$RUNTIME_LOCATION --project=$PROJECT_ID

      Sostituisci quanto segue:

      • NEG_NAME: il nome del gruppo di endpoint di rete.
      • TARGET_SERVICE: il nome del collegamento al servizio a cui vuoi connetterti. Ad esempio: projects/bfac7497a40c32a12p-tp/regions/us-west1/serviceAttachments/apigee-us-west1-crw7
    5. Crea un servizio di backend per il NEG.
      gcloud compute backend-services create BACKEND_SERVICE_NAME \
        --load-balancing-scheme=EXTERNAL_MANAGED \
        --protocol=HTTPS \
        --region=$RUNTIME_LOCATION  \
        --project=$PROJECT_ID
    6. Sostituisci BACKEND_SERVICE_NAME con il nome del servizio di backend.

    7. Aggiungi il servizio di backend al NEG.
      gcloud compute backend-services add-backend BACKEND_SERVICE_NAME \
        --network-endpoint-group=NEG_NAME \
        --region=$RUNTIME_LOCATION  \
        --project=$PROJECT_ID

      Sostituisci quanto segue:

      • BACKEND_SERVICE_NAME: il nome del servizio di backend.
      • NEG_NAME: il nome del gruppo di endpoint di rete.
    8. Crea una mappa URL per il bilanciatore del carico.

      Una mappa URL deve fare riferimento a un servizio di backend predefinito. Imposta il servizio di backend che appena creato come predefinito.

      gcloud compute url-maps create URL_MAP_NAME \
        --default-service=DEFAULT_BACKEND_SERVICE_NAME \
        --region=$RUNTIME_LOCATION  \
        --project=$PROJECT_ID

      Sostituisci quanto segue:

      • URL_MAP_NAME: un nome per la mappa URL.
      • DEFAULT_BACKEND_SERVICE_NAME: il nome del servizio di backend predefinito del bilanciatore del carico. L'impostazione predefinita viene utilizzata quando nessuna regola host corrisponde al nome host richiesto.
    9. Crea il proxy HTTPS di destinazione.

      Devi disporre di una risorsa del certificato SSL da utilizzare nella Proxy HTTPS di destinazione.

      Utilizza questo comando per creare una risorsa del certificato SSL autogestito. Per creare un certificato SSL autogestito, sono necessari un file di chiave privata locale e un certificato locale . Se devi creare questi file, consulta il passaggio 1 sull'utilizzo dei certificati SSL autogestiti.

      gcloud compute ssl-certificates create CERTIFICATE \
        --certificate LB_CERT \
        --private-key LB_PRIVATE_KEY --region=$RUNTIME_LOCATION \
        --project=$PROJECT_ID

      Sostituisci quanto segue:

      • CERTIFICATE: un nome per il certificato.
      • LB_CERT: il percorso del file del certificato in formato PEM per il certificato autogestito.
      • LB_PRIVATE_KEY: il percorso del file della chiave privata in formato PEM per il certificato autogestito.
    10. Aggiungi il dominio al gruppo di ambienti Apigee creato per te. Il nome del gruppo di ambienti è eval-group:
      curl "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/envgroups/eval-group" \
            -H "$AUTH" \
            -X PATCH \
            -H "Content-Type:application/json" \
            -d '{
              "hostnames":["'"DOMAIN"'"]
            }'
    11. Controlla lo stato dell'operazione del gruppo di ambienti:
      curl -H "$AUTH" \
            "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/envgroups/eval-group/attachments"
          
    12. Utilizza la risorsa del certificato SSL per creare un proxy HTTPS di destinazione.

      gcloud compute target-https-proxies create PROXY_NAME \
        --url-map=URL_MAP_NAME --region=$RUNTIME_LOCATION \
        --ssl-certificates=CERTIFICATE --project=$PROJECT_ID

      Sostituisci quanto segue:

      • PROXY_NAME: un nome per il proxy HTTPS di destinazione.
      • URL_MAP_NAME: il nome della mappa URL.
      • CERTIFICATE: il nome della risorsa del certificato.
    13. Prenota un indirizzo esterno regionale per il bilanciatore del carico. Tieni presente che il livello di rete deve essere impostato su STANDARD.
      gcloud compute addresses create ADDRESS_NAME \
            --region=$RUNTIME_LOCATION --network-tier=STANDARD \
            --project=$PROJECT_ID

      Sostituisci ADDRESS_NAME con un nome per la risorsa dell'indirizzo IP.

      Esegui questo comando per visualizzare l'indirizzo IP riservato:

      gcloud compute addresses describe ADDRESS_NAME \
            --format="get(address)" --region=$RUNTIME_LOCATION \
            --project=$PROJECT_ID
    14. Crea la regola di forwarding.
      gcloud compute forwarding-rules create FWD_RULE \
        --load-balancing-scheme=EXTERNAL_MANAGED \
        --network-tier=STANDARD \
        --address=ADDRESS_NAME \
        --target-https-proxy=PROXY_NAME \
        --ports=443  --region=$RUNTIME_LOCATION \
        --target-https-proxy-region=$RUNTIME_LOCATION --project=$PROJECT_ID

      Sostituisci quanto segue:

      • FWD_RULE: un nome per la regola di forwarding.
      • ADDRESS_NAME: la risorsa dell'indirizzo IP che hai prenotato per l'utilizzo per la regola di forwarding.
      • PROXY_NAME: il nome del proxy HTTPS di destinazione.

    Provisioning di Apigee completato. Vai a Chiamare il proxy API di esempio.

    Passaggio 5: chiama il proxy API di esempio

    Un proxy API chiamato hello-world sia stato creato e distribuito automaticamente durante il provisioning. In questo passaggio testerai il nuovo di valutazione dell'organizzazione chiamando il proxy.

    Chiama il proxy API con instradamento interno

    Se hai scelto un routing interno con un'opzione endpoint di servizio nel passaggio 5, segui i passaggi descritti in Chiamata a un proxy API con accesso solo interno.

    Chiama il proxy API con routing esterno

    Se hai scelto un'opzione di routing esterno nel passaggio 5, segui i passaggi descritti in questa sezione.

    1. Configura una voce DNS per il tuo dominio. Ecco due modi per eseguire questa operazione:
      • Nel tuo registrar, crea un record A che rimandi al tuo dominio. Ad esempio, se il dominio è sales.example.com e l'IP è 10.23.0.2, quindi punta la record per sales.example.com all'indirizzo 10.23.0.2.

        Esegui questo comando per visualizzare l'indirizzo IP riservato:

        gcloud compute addresses describe ADDRESS_NAME \
            --format="get(address)" --region=$RUNTIME_LOCATION \
            --project=$PROJECT_ID
      • Utilizza Google Cloud DNS per mappare un URL a un indirizzo IP.
    2. Verifica che sia stato eseguito il deployment del proxy hello-world:
      curl -i -H "$AUTH" \
        "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/environments/eval/apis/hello-world/revisions/1/deployments"
    3. Chiama il proxy API:

      Invia una richiesta al proxy API da qualsiasi macchina abilitata in rete eseguendo il comando seguente comando:

      curl -i -H "Host: DOMAIN" \
        https://DOMAIN/hello-world

      Dove DOMAIN è il dominio che inserisci nel certificato e aggiunte al gruppo di ambienti, come descritto nel Passaggio 5: configura il routing. Se necessario, puoi utilizzare questo API per ottenere il valore DOMAIN dal gruppo di ambienti:

      curl -i -H "$AUTH" \
        "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/envgroups"

      Se l'operazione riesce, il proxy API di esempio restituisce la risposta:

      Hello, Guest!

      Suggerimenti per la risoluzione dei problemi:

      Se ricevi un errore di handshake, controlla lo stato del certificato SSL. Per informazioni su risoluzione dei problemi relativi ai certificati autogestiti e gestiti da Google, consulta Risolvi i problemi relativi ai certificati SSL.

      Assicurati che il tuo dominio registrato abbia un Un record che punta all'indirizzo IP dell'indirizzo IPv4 esterno globale creato nel passaggio 5. Esegui questo comando per visualizzare l'indirizzo IP riservato:

      gcloud compute addresses describe ADDRESS_NAME \
                    --format="get(address)" --region=$RUNTIME_LOCATION \
                    --project=$PROJECT_ID

      Se non riesci a risolvere la configurazione del dominio, prova a chiamare il proxy con questo comando:

      curl  -H Host:DOMAIN --resolve \
        DOMAIN:443:EXTERNAL_IP_ADDRESS  \
        https://DOMAIN:443/hello-world -k

    Passaggio successivo: per saperne di più sulla creazione e sul deployment dei proxy API, consulta Crea la tua prima panoramica del proxy API.