Questa sezione illustra varie operazioni amministrative, ad esempio la creazione, la gestione e la rimozione di organizzazioni, ambienti e host virtuali Apigee in un'installazione di Apigee Edge for Private Cloud.
Per un'introduzione a organizzazioni, ambienti e host virtuali, consulta Informazioni su pianeti, regioni, pod, organizzazioni, ambienti e host virtuali.
Controllo dello stato di utenti, organizzazione e ambiente
Il server di gestione svolge un ruolo fondamentale nel tenere insieme tutti gli altri componenti in un'installazione on-premise di Edge Private Cloud. Puoi controllare lo stato di utenti, organizzazioni e deployment sul server di gestione eseguendo i seguenti comandi curl:
curl -u adminEmail:admin_passwd http://localhost:8080/v1/userscurl -u adminEmail:admin_passwd http://localhost:8080/v1/organizationscurl -u adminEmail;:admin_passwd http://localhost:8080/v1/organizations/orgname/deployments
Il sistema dovrebbe visualizzare lo stato HTTP 200 per tutte le chiamate. Se questi passaggi non funzionano, procedi nel seguente modo:
- Controlla i log del server di gestione in
/opt/apigee/var/log/apigee/management-serverper verificare la presenza di errori. - Effettua una chiamata al server di gestione per verificare se funziona correttamente.
- Rimuovi il server dall'ELB, quindi riavvia il server di gestione:
/opt/apigee/bin/apigee-service management-server restart
Informazioni sull'utilizzo dei file di configurazione
I comandi mostrati di seguito accettano un file di configurazione come input. Ad esempio, passi un file di configurazione al comando setup-org per definire tutte le proprietà dell'organizzazione, inclusi l'ambiente e l'host virtuale.
Per un file di configurazione completo e informazioni sulle proprietà che puoi impostare nel file di configurazione, consulta Esegui l'onboarding di un'organizzazione.
Informazioni sulla configurazione di un host virtuale
Un host virtuale su Edge definisce i domini e le porte del router Edge su cui è esposto un proxy API e, per estensione, l'URL utilizzato dalle app per accedere a un proxy API. Un host virtuale definisce anche se l'accesso al proxy API avviene tramite il protocollo HTTP o tramite il protocollo HTTPS criptato.
Utilizza gli script e le chiamate API mostrati di seguito per creare un host virtuale. Quando crei l'host virtuale, devi specificare le seguenti informazioni:
- Il nome dell'host virtuale che utilizzi per fare riferimento all'host nei proxy API.
- La porta sul router per l'host virtuale. In genere, queste porte iniziano da 9001 e aumentano di uno per ogni nuovo host virtuale.
- L'alias host dell'host virtuale. In genere il nome DNS dell'host virtuale.
Il router perimetrale confronta l'intestazione Host della richiesta in entrata con l'elenco degli alias host per determinare il proxy API che gestisce la richiesta. Quando effettui una richiesta tramite un host virtuale, specifica un nome di dominio che corrisponda all'alias host di un host virtuale o specifica l'indirizzo IP del router e l'intestazione Host contenente l'alias host.
Ad esempio, se hai creato un host virtuale con un alias host di myapis.apigee.net sulla porta 9001, esegui una richiesta curl a un'API tramite quell'host virtuale potrebbe utilizzare una delle seguenti forme:
- Se hai una voce DNS per myapis.apigee.net:
curl http://myapis.apigee.net:9001/proxy-base-path/resource-path
- Se non hai una voce DNS per myapis.apigee.net:
curl http://routerIP:9001/proxy-base-path/resource-path -H 'Host: myapis.apigee.net'
Nella seconda forma, specifichi l'indirizzo IP del router e passi l'alias host nell'intestazione Host.
Opzioni quando non hai una voce DNS per l'host virtuale
Un'opzione quando non hai una voce DNS è impostare l'alias host sull'indirizzo IP del router e sulla porta dell'host virtuale, ad esempio routerIP:port. Ad esempio:
192.168.1.31:9001
Quindi, esegui un comando curl nel formato seguente:
curl http://routerIP:9001/proxy-base-path/resource-path
Questa opzione è preferibile perché funziona bene con la UI di Edge.
Se hai più router, aggiungi un alias host per ogni router, specificando l'indirizzo IP di ogni router e la porta dell'host virtuale.
In alternativa, puoi impostare l'alias host su un valore, ad esempio temp.hostalias.com.
In questo caso, devi passare l'intestazione Host in ogni richiesta:
curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'Host: temp.hostalias.com'
In alternativa, aggiungi l'alias host al file /etc/hosts. Ad esempio, aggiungi questa riga a /etc/hosts:
192.168.1.31 temp.hostalias.com
Puoi quindi effettuare una richiesta come se avessi una voce DNS:
curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path