Provisioning di un'organizzazione di valutazione

Questa pagina si applica ad Apigee, ma non ad Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Questa sezione descrive come configurare un'organizzazione di valutazione Apigee (o eval org) utilizzando la configurazione guidata di Apigee. Per ulteriori informazioni, consulta Tipi di organizzazioni.

Suggerimento: ti consigliamo di consultare l'argomento Architettura Apigee prima di eseguire i passaggi di provisioning.

Video: guarda questo breve video per scoprire come configurare e testare un'organizzazione di valutazione Apigee.

Creazione di un'organizzazione di valutazione con la procedura guidata di provisioning di Apigee

Questa sezione descrive come utilizzare la configurazione guidata di Apigee per creare un'organizzazione di valutazione.

Inizia

Autorizzazioni richieste per questa attività

Il provisioning di Apigee deve disporre di autorizzazioni sufficienti per utilizzare la procedura guidata. Per concedere questa autorizzazione, un amministratore di Google Cloud può assegnare al provisioning di Apigee il ruolo predefinito Amministratore dell'organizzazione Apigee oppure concedere altre autorizzazioni granulari per fornire il privilegio minimo necessario.

1. Assicurati di soddisfare i prerequisiti prima di continuare.
2. Se non l'hai ancora fatto, crea un progetto Google Cloud.

3. Avvia la procedura guidata di provisioning di Apigee in un browser.

   Il riquadro Configura Apigee della procedura guidata di provisioning di Apigee mostra:

   

4. Inserisci l'ID del tuo progetto Google Cloud nel campo Progetto.

   

   Se non disponi dell'autorizzazione per gestire il progetto o se il progetto non esiste, verrà visualizzato un messaggio di errore. Assicurati che l'ID progetto inserito sia corretto e che si tratti dell'ID progetto e non del nome del progetto, se sono diversi.

   Se il progetto è già associato a un account Apigee a pagamento, non puoi creare un'organizzazione di valutazione per il progetto. Consulta Provisioning > Organizzazioni a pagamento > Prima di iniziare per utilizzare la procedura guidata di provisioning di Apigee per eseguire il provisioning di un'organizzazione a pagamento.

   Nota: la procedura guidata di provisioning di Apigee tiene traccia dei passaggi per questo progetto. Una volta completato un passaggio, puoi uscire dalla procedura guidata. Quando torni alla pagina e inserisci nuovamente l'ID progetto, verrà visualizzato il passaggio successivo.
5. Fai clic su AVVIA VALUTAZIONE.
6. La procedura guidata di provisioning di Apigee mostra la pagina Configura la valutazione di Apigee. Man mano che completi ogni passaggio, l'icona MODIFICA viene visualizzata accanto al passaggio successivo.

Abilita API

Autorizzazioni richieste per questa attività

Puoi assegnare al provisioning di Apigee un ruolo predefinito che includa le autorizzazioni necessarie per completare questa attività oppure autorizzazioni più granulari per fornire il privilegio minimo necessario. Consulta Ruoli predefiniti e Autorizzazioni di abilitazione dell'API.

Abilita le API Google Cloud necessarie per il funzionamento di Apigee.

1. Fai clic su MODIFICA accanto ad Abilita API per abilitare le API richieste per l'organizzazione di valutazione.
2. Fai clic su ABILITA API nel riquadro Abilita API della procedura guidata. Verranno attivati per il tuo progetto:
   • API Apigee
   • API Compute Engine
   • API Service Networking
3. Attendi qualche istante per il completamento del passaggio. Al termine, accanto al passaggio Abilita API verrà visualizzato un segno di spunta e sarà disponibile il passaggio Networking.
   Suggerimento: puoi visualizzare le API abilitate per il tuo progetto nella dashboard API e servizi della piattaforma Google Cloud.

Networking

Autorizzazioni richieste per questa attività

Puoi assegnare al provisioning di Apigee un ruolo predefinito che includa le autorizzazioni necessarie per completare questa attività oppure autorizzazioni più granulari per fornire il privilegio minimo necessario. Consulta la sezione Ruoli predefiniti e Autorizzazioni di rete del servizio.

Configura la rete per il tuo Virtual Private Cloud (VPC) locale.

1. Fai clic su MODIFICA accanto a Networking.

   Viene visualizzato il riquadro Configura il networking:

   

2. Seleziona una rete dall'elenco a discesa Rete autorizzata. Per la maggior parte delle organizzazioni di valutazione, dovrai selezionare default, ovvero la rete creata per te da Google Cloud quando hai creato il tuo progetto Google Cloud. Se hai una rete cloud diversa e vuoi utilizzarla, selezionala dall'elenco. Tieni presente che la rete deve avere un blocco CIDR di indirizzi IP di /22 libero.

   Se il progetto utilizza la rete virtual private cloud (VPC) condivisa, seleziona la rete che gestisce le impostazioni di rete del progetto. Se non vedi la rete nell'elenco a discesa, chiedi a un utente che dispone dell'autorizzazione per gestire la rete di accedere per completare questo passaggio. Dopodiché puoi tornare alla procedura guidata e continuare. Per ulteriori informazioni sulla rete VPC condiviso, consulta Utilizzare le reti VPC condivise.

   Dopo aver selezionato una rete, la procedura guidata mostra le opzioni di selezione dell'intervallo di peering:

   

3. Seleziona la modalità di identificazione degli indirizzi IP per la tua rete da parte di Apigee. Per le organizzazioni di valutazione, è più comune selezionare Alloca automaticamente l'intervallo IP. Se preferisci specificare un intervallo, seleziona Seleziona uno o più intervalli IP esistenti o creane uno nuovo. Devi specificare sia un nome sia un intervallo IP specifico, ad esempio 10.20.238.0/22.

   Fai clic su ALLOCA E COLLEGA per continuare.

   La procedura guidata crea la rete e assegna gli indirizzi IP per i servizi al suo interno. La creazione della rete richiede un paio di minuti.

Organizzazione di valutazione Apigee

Autorizzazioni richieste per questa attività

Puoi assegnare al provisioning di Apigee ruoli predefiniti che includono le autorizzazioni necessarie per completare questa attività oppure autorizzazioni più granulari per fornire il privilegio minimo necessario. Consulta Ruoli predefiniti o Autorizzazioni per la creazione di organizzazioni (eval org).

Crea un'organizzazione di valutazione Apigee.

1. Fai clic su MODIFICA accanto a Organizzazione di valutazione Apigee.

   Viene visualizzato il riquadro Crea un'organizzazione di valutazione Apigee:

   

2. Seleziona una regione di hosting di analisi e una posizione di runtime. Per un elenco delle località di Apigee API Analytics e di runtime disponibili, consulta Località Apigee.

3. Fai clic su PROVISION.

   La procedura guidata di provisioning di Apigee crea l'organizzazione di valutazione e la relativa istanza di runtime associata. L'organizzazione di valutazione avrà lo stesso nome e ID del tuo ID progetto.

   Nota: questa operazione può richiedere fino a 45 minuti.

   Al termine, accanto al passaggio Organizzazione di valutazione Apigee verrà visualizzato un segno di spunta e sarà disponibile il passaggio Routing degli accessi.

Routing degli accessi

In questo passaggio, scegli se esporre il nuovo cluster alle richieste esterne o mantenerlo privato (e consentire solo le richieste dall'interno del tuo VPC). Il modo in cui accedi ai proxy API dipende dal fatto che tu decida di consentire richieste esterne o richieste limitate solo per uso interno:

Tipo di accesso	Descrizione della procedura di configurazione e di deployment
Esterno	Consenti l'accesso esterno ai proxy API. La procedura guidata esegue il deployment di un proxy Hello World nella tua istanza di runtime. Puoi quindi inviare una richiesta al proxy API dalla tua macchina di amministrazione o da qualsiasi macchina con accesso a internet.
Interno	Consenti solo l'accesso interno ai proxy API. La procedura guidata esegue il deployment di un proxy Hello World nella tua istanza di runtime. Devi creare manualmente una nuova VM all'interno della VPC e connetterti. Dalla nuova VM puoi inviare richieste al proxy API. Attenzione: a causa di una limitazione del bilanciatore del carico delle applicazioni interno di Google Cloud, l'opzione di routing interno di Apigee non supporta le richieste HTTP 1.0. Le richieste in arrivo del client che specificano il protocollo HTTP 1.0 non andranno a buon fine. Sono supportate le versioni HTTP successive.

Segui i passaggi riportati di seguito nella scheda Accesso esterno o Accesso interno:

Accesso esterno

Questa sezione descrive come configurare il routing quando utilizzi la procedura guidata di provisioning di Apigee e vuoi consentire l'accesso esterno al tuo proxy API.

Autorizzazioni richieste per questa attività

Puoi assegnare al provisioning di Apigee un ruolo predefinito che includa le autorizzazioni necessarie per completare questa attività oppure autorizzazioni più granulari per fornire il privilegio minimo necessario. Consulta Ruoli predefiniti e Autorizzazioni di instradamento dell'accesso.

Per configurare il routing per l'accesso esterno nella configurazione guidata di Apigee:

1. Apri la procedura guidata di provisioning di Apigee, se non è attualmente aperta. La procedura guidata torna all'attività incompleta più recente nell'elenco.

2. Fai clic su MODIFICA accanto a Routing di accesso.

3. Seleziona Attiva l'accesso a internet dal riquadro Configura l'accesso.

   La procedura guidata mostra opzioni aggiuntive per la configurazione dell'istanza:

   

4. Per l'impostazione del dominio, inserisci un nome DNS valido di tua proprietà o scegli di utilizzare un servizio DNS jolly, ad esempio nip.io. Se scegli il servizio wildcard, ti viene riservato un indirizzo IP esterno statico. L'opzione jolly è facile da usare, ma è consigliata solo a scopo di test.
5. (Facoltativo) Puoi modificare il nome dell'istanza della macchina virtuale con un nome più significativo. Nell'ambito della procedura di provisioning, Apigee crea un gruppo di istanze gestite (MIG) contenente più VM per eseguire il proxy del traffico tra il bilanciatore del carico e il runtime Apigee. Per modificare il nome dell'istanza VM, fai clic su MODIFICA e apporta le modifiche.
6. Seleziona la subnet utilizzata per ospitare il gruppo di istanze gestite di VM da collegare al runtime Apigee. Le dimensioni della subnet possono essere ridotte (ad es. /28) in quanto deve ospitare al massimo tre VM. La subnet può essere condivisa e utilizzata da VM o altre entità.

7. Se utilizzi un servizio DNS jolly, tieni presente che verrà creato un certificato gestito da Google per il dominio. Non devi intraprendere ulteriori azioni. Consulta anche Utilizzo di certificati SSL gestiti da Google.

   Se utilizzi il tuo dominio, scegli se fornire un certificato gestito da te o utilizzare un certificato gestito da Google:

   • Fornisci un certificato autogestito:
     1. Genera una coppia di certificati/chiavi se non ne hai già una. Per gli ambienti di test, può essere un certificato autofirmato. Per un sistema di produzione, devi utilizzare un certificato firmato da un'autorità di certificazione. Consulta Utilizzo dei certificati SSL autogestiti.
     2. Nei rispettivi campi, sfoglia il file system e allega i file contenenti il certificato e la chiave privata. Entrambi devono essere in formato PEM.
   • Utilizza un certificato gestito da Google. Per utilizzare un certificato gestito da Google, non inserire un certificato firmato o una chiave privata RSA. Il certificato gestito da Google verrà creato per te.

8. Fai clic su IMPOSTA ACCESSO.

   Apigee prepara il cluster per l'accesso esterno. Ciò include la configurazione del traffico proxy dell'MIG, la creazione di regole firewall, il caricamento dei certificati e la creazione di un bilanciatore del carico.

   Il completamento di questa operazione può richiedere diversi minuti.

9. Quando Apigee termina la configurazione dell'accesso del runtime, vedrai un segno di spunta blu accanto a tutti i passaggi della procedura guidata:

   

10. Fai clic su CONTINUA.

    La procedura guidata mostra Passaggi successivi consigliati. I passaggi mostrati dipendono dal fatto che tu abbia utilizzato il tuo nome DNS o un DNS jolly.

    Nota: le modifiche DNS vengono pubblicate immediatamente, ma la propagazione potrebbe richiedere tempo. A causa di questo ritardo, potresti dover attendere fino a un'ora prima di poter chiamare il proxy di esempio.
    • Se hai specificato il tuo nome di dominio, vai al tuo registrar del dominio e crea un record A per il nome host del dominio che punti all'indirizzo IP mostrato nella procedura guidata. Al termine, fai clic su Avvia per chiamare il proxy API di cui è stato eseguito il deployment per te.
    • Se hai utilizzato un DNS jolly, fai clic su Avvia per chiamare il proxy API hello-world che è stato disegnato per te.
11. (Facoltativo) Aggiungi utenti e ruoli per la tua organizzazione. Consulta Utenti e ruoli.

Hai completato i passaggi per configurare l'accesso a internet esterno ai proxy API.

Accesso interno

Questa sezione descrive come configurare il routing quando utilizzi la configurazione guidata di Apigee e non vuoi consentire l'accesso esterno al proxy API. Vuoi invece limitare l'accesso solo alle richieste interne provenienti dall'interno della VPC.

Attenzione: a causa di una limitazione del bilanciatore del carico delle applicazioni interno di Google Cloud, l'opzione di routing interno di Apigee non supporta le richieste HTTP 1.0. Le richieste in arrivo del client che specificano il protocollo HTTP 1.0 non andranno a buon fine. Sono supportate le versioni HTTP successive.

Per configurare il routing per l'accesso interno nella procedura guidata di provisioning di Apigee:

1. Fai clic su MODIFICA accanto al passaggio Routing dell'accesso.

2. Seleziona Nessun accesso a internet nel riquadro Configura l'accesso al gruppo env 'eval-group'.

3. Fai clic su CONTINUA.

4. Vedrai un segno di spunta blu accanto a tutti i passaggi della procedura guidata. Ciò indica che tutti i passaggi sono stati completati correttamente:

   

5. Fai clic su CONTINUA.
6. Per testare la tua organizzazione appena provisionata, segui le istruzioni riportate in Chiamata a un proxy API con accesso solo interno. In questi passaggi, creerai una macchina virtuale (VM) all'interno del tuo VPC da cui le richieste proxy API possono essere inviate al bilanciatore del carico interno (ingress), che le inoltra all'istanza di runtime Apigee. Per praticità, la procedura guidata di provisioning ha creato e disegnato per te un proxy di test chiamato hello-world.
7. (Facoltativo) Aggiungi utenti e ruoli per la tua organizzazione. Consulta Utenti e ruoli.

Se si verificano errori durante questa parte della procedura, consulta la sezione Risoluzione dei problemi.

Visualizzare i dettagli dell'organizzazione

Infine, apri l'interfaccia utente di Apigee per visualizzare i dettagli della tua organizzazione.

Autorizzazioni richieste per questa attività

Se disponi del ruolo Amministratore dell'organizzazione Apigee, puoi completare questa attività. Per scoprire altri ruoli che puoi impiegare per utilizzare l'interfaccia utente di Apigee, consulta Ruoli Apigee.

1. Fai clic su APRI CONSOLE APIGEE per aprire la UI di Apigee.
2. Assicurati che il progetto appena creato sia selezionato nell'interfaccia utente di Apigee. Ad esempio:

   

   Se l'organizzazione che hai appena creato non è quella selezionata, fai clic sul nome del progetto per visualizzare un elenco di progetti.

   Se il tuo progetto non è nell'elenco dei progetti disponibili, potrebbe essere necessario attendere qualche minuto prima che diventi disponibile. Aggiorna il browser e riprova.

3. Fai clic su Amministrazione per visualizzare la configurazione della tua organizzazione:

   Località	Proprietà	Valore
   Amministrazione > Istanze	Nome	eval-instance
   	Indirizzo IP	Si tratta dell'indirizzo IP del bilanciatore del carico interno della tua organizzazione.
   Amministrazione > Ambienti > Panoramica	Nome ambiente	eval
   Amministrazione > Ambienti > Gruppi	Gruppo di ambienti	eval-group
   Amministrazione > Ambienti > Gruppi	Nomi host	PROJECT_NAME-eval.apigee.net

4. Fai clic su Sviluppa > Proxy API. Apigee ha creato per te un proxy API denominato hello-world quando hai eseguito il provisioning dell'organizzazione di valutazione.

   Località	Proprietà	Valore
   Sviluppa > Proxy API	proxy API	hello-world

Eliminazione di un'organizzazione di valutazione

Per eliminare (o eseguire il deprovisioning) un'organizzazione di valutazione, utilizza il comando gcloud alpha apigee organizations delete.