Manutenzione dell'organizzazione e dell'ambiente

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, vedi Informazioni su pianeti, regioni, pod, organizzazioni, ambienti e host virtuali.

Controllare lo 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 mostrare lo stato HTTP 200 per tutte le chiamate. Se non vanno a buon fine, procedi nel seguente modo:

  1. Controlla la presenza di errori nei log del server di gestione all'indirizzo /opt/apigee/var/log/apigee/management-server.
  2. Effettua una chiamata al server di gestione per verificare che funzioni correttamente.
  3. Rimuovi il server da ELB e 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 prendono come input un file di configurazione. 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 Eseguire 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 viene esposto un proxy API e, per estensione, l'URL che le app utilizzano 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 farvi riferimento nei tuoi 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.

    L'Edge Router confronta l'intestazione Host della richiesta in entrata con l'elenco degli alias host come parte della determinazione del 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 oppure specifica l'indirizzo IP del router e l'intestazione Host contenente l'alias host.

Se hai una voce DNS per l'host virtuale

Ad esempio, se hai creato un host virtuale con un alias host myapis.apigee.net sulla porta 9001, l'esecuzione di una richiesta curl a un'API tramite l'host virtuale potrebbe utilizzare il seguente formato:

curl http://myapis.apigee.net:9001/proxy-base-path/resource-path

Opzioni quando non hai una voce DNS per l'host virtuale

Una delle opzioni 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

Poi esegui un comando curl nel formato seguente:

curl http://routerIP:9001/proxy-base-path/resource-path

Questa opzione è preferibile perché funziona bene con l'interfaccia utente Edge.

Se hai più router, aggiungi un alias host per ciascun 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 trasmettere 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

A questo punto puoi effettuare una richiesta come se avessi una voce DNS:

curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path