Manutenzione dell'organizzazione e dell'ambiente

Edge for Private Cloud v4.19.01

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

Per un'introduzione a organizzazioni, ambienti e host virtuali, consulta Informazioni su pianeti, regioni, pod, organizzazioni, ambienti e host virtuali.

Verifica dello stato di utenti, organizzazione e ambiente

Management Server svolge un ruolo fondamentale nel riunire tutti gli altri componenti in un'installazione on-premise di Edge Private Cloud. Puoi verificare lo stato di utenti, organizzazioni e 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 questi passaggi non risolvono il problema, 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. Esegui una chiamata al server di gestione per verificare se funziona correttamente.
  3. Rimuovi il server dall'ELB e riavvia il server di gestione: 
    /opt/apigee/bin/apigee-service management-server restart

Informazioni sull'utilizzo dei file di configurazione

I comandi riportati di seguito accettano un file di configurazione come input. Ad esempio, puoi passare 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 è esposto un proxy API e, per estensione, l'URL utilizzato dalle app per accedere a un proxy API. Un host virtuale inoltre definisce se si accede 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'hosting 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 partono 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 Edge confronta l'intestazione Host della richiesta in arrivo con l'elenco di alias host per determinare il proxy API che gestisce la richiesta. Quando effettui una richiesta tramite un host virtuale, specifica un nome di dominio corrispondente all'alias host di un host virtuale oppure 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, puoi eseguire una richiesta curl a un'API tramite questo host virtuale utilizzando uno dei seguenti formati:

  • 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.

Opzioni se 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

Poi, crea un comando curl nel seguente formato:

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

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

Se hai più router, aggiungi un alias host per ogni router, specificando l'indirizzo IP di ciascun 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 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

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

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