Manutenzione dell'organizzazione e dell'ambiente

Questa sezione illustra varie operazioni amministrative, ad esempio creazione, gestione e rimozione di organizzazioni, ambienti e host virtuali Apigee in un'installazione Apigee Edge per cloud privato.

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 vitale nel tenere insieme tutti gli altri componenti in un'installazione on-premise di Edge Private Cloud. Puoi controllare lo stato degli utenti, dell'organizzazione e del deployment sul server di gestione inviando 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 il problema persiste, procedi nel seguente modo:

  1. Verifica la presenza di eventuali 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, 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 ambiente e 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 perimetrale su cui è esposto un proxy API e, per estensione, l'URL che le app utilizzano per accedere a un proxy API. Un host virtuale definisce inoltre se è possibile accedere al proxy API utilizzando il protocollo HTTP o 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 proxy API.
  • La porta sul router per l'host virtuale. In genere queste porte iniziano da 9001 e si incrementano di una 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 di alias host nell'ambito 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 dell'host contenente l'alias host.

Ad esempio, se hai creato un host virtuale con un alias host di myapis.apigee.net sulla porta 9001, puoi eseguire una richiesta curl a un'API tramite l'host virtuale. Puoi utilizzare uno dei seguenti moduli:

  • Se hai una voce DNS per myapis.apigee.net: 
    curl http://myapis.apigee.net:9001/proxy-base-path/resource-path
  • Se non disponi di 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.

Opzioni disponibili quando non è disponibile una voce DNS per l'host virtuale

Se non hai una voce DNS, un'opzione è impostare l'alias host sull'indirizzo IP del router e della porta dell'host virtuale, come routerIP:port. Ad esempio:

192.168.1.31:9001

Poi devi creare un comando curl nel modulo seguente:

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

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

Se disponi di 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 un valore per l'alias host, ad esempio temp.hostalias.com. Successivamente, devi passare l'intestazione Host a 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

Quindi puoi effettuare una richiesta come se avessi una voce DNS:

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