Edge for Private Cloud v4.18.01
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/users curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations curl -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-server per verificare la presenza di eventuali 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 myapis.apigee.net sulla porta 9001, 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'
Nel secondo modulo, specifichi l'indirizzo IP del router e passi l'alias host nell'intestazione Host.
Nota: il comando curl, la maggior parte dei browser e molte altre utilità aggiungono automaticamente l'intestazione Host con il dominio come parte della richiesta, quindi puoi effettivamente utilizzare un comando curl nel formato:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}
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, come <routerIP>:port. Ad esempio:
192.168.1.31:9001
Quando 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. Poi, 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}