Edge per Private Cloud v4.18.05
Utilizza lo script setup-org
per eseguire il processo di inserimento. Devi eseguire lo script sul nodo del server di gestione.
Per eseguire l'onboarding di un'organizzazione:
- Installa
apigee-provision
sul nodo del server di gestione:/opt/apigee/apigee-service/bin/apigee-service apigee-provision install
- Esegui lo script
setup-org
sul nodo del server di gestione:/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
Il file di configurazione deve essere leggibile dall'utente "apigee". Per un file di configurazione di esempio, consulta File di configurazione di inserimento.
- Verifica di aver completato l'onboarding di un'organizzazione. Un modo per farlo è accedere
all'interfaccia utente richiedendo il seguente URL in un browser:
http://IP_address:9000/login
Dove IP_address è l'indirizzo IP del server su cui hai installato l'interfaccia utente Edge.
Per ulteriori passaggi di verifica, consulta Verificare l'onboarding.
- Crea il tuo primo proxy.
File di configurazione per l'onboarding
Per eseguire una configurazione silenziosa con lo script setup-org
, trasmetti un file di configurazione con l'opzione -f
, come illustrato nell'esempio seguente:
/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
Questa sezione include un file di configurazione di esempio per l'onboarding di un'organizzazione con
setup-org
.
Durante l'onboarding di un'organizzazione, lo script setup-org
esegue quanto segue:
- Crea una nuova organizzazione.
- Crea un ambiente.
- Crea un host virtuale per l'ambiente.
- Imposta l'utente specificato come amministratore dell'organizzazione. Tieni presente che:
- Puoi utilizzare un utente esistente o crearne uno nuovo per l'amministratore dell'organizzazione.
- L'amministratore dell'organizzazione non deve essere uguale all'amministratore di sistema.
- Associa l'organizzazione al pod "gateway". Questa è l'impostazione predefinita e non può essere modificata.
- Associa l'ambiente a tutti i processori di messaggi.
- Abilita l'analisi.
Copia l'esempio seguente e apporta le modifiche necessarie per integrare la tua organizzazione:
IP1=192.168.1.1 # Specify the IP or DNS name of the Management Server. MSIP="$IP1" # Specify the Edge sys admin credentials. ADMIN_EMAIL="admin@email.com" APIGEE_ADMINPW=admin_password # If omitted, you are prompted for it. # Specify organization name. ORG_NAME=myorg # lowercase only, no spaces, underscores, or periods. # Specify the organization administrator user. # Either specify an existing user, or specify the information # necessary to create a new user. # Do not use the sys admin as the organization administrator. # # Create a new user for the organization administrator. NEW_USER="y" # New user information if NEW_USER="y". USER_NAME=new@user.com FIRST_NAME=new LAST_NAME=user # Org admin password must be at least 8 characters long and contain one uppercase # letter, one lowercase letter, and one digit or special character USER_PWD="newUserPword" ORG_ADMIN=new@user.com # # Or, specify an existing user as the organization admin, # omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD. # NEW_USER="n" # ORG_ADMIN=existing@user.com # Specify environment name. ENV_NAME=prod # lowercase only # Specify virtual host information. VHOST_PORT=9001 VHOST_NAME=default # If you have a DNS entry for the virtual host. VHOST_ALIAS=myorg-test.apigee.net # If you do not have a DNS entry for the virtual host, # specify the IP and port of each router as a space-separated list: # VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001" # Optionally configure TLS/SSL for virtual host. # VHOST_SSL=y # Set to "y" to enable TLS/SSL on the virtual host. # KEYSTORE_JAR= # JAR file containing the cert and private key. # KEYSTORE_NAME= # Name of the keystore. # KEYSTORE_ALIAS= # The key alias. # KEY_PASSWORD= # The key password, if it has one. # Specify the analytics group. # AXGROUP=axgroup-001 # Default name is axgroup-001.
Note:
- Per
VHOST_ALIAS
, se hai già un record DNS che utilizzerai per accedere all'host virtuale, specifica l'alias host e, facoltativamente, la porta, ad esempio "myapi.example.com". Se non hai ancora un record DNS, puoi utilizzare l'indirizzo IP del router.
Per ulteriori informazioni su come configurare l'host virtuale, consulta Configurazione di un host virtuale.
- Per la configurazione TLS/SSL, consulta gli articoli Archivio chiavi e truststore e Configurazione dell'accesso TLS a un'API per il cloud privato per ulteriori informazioni sulla creazione del file JAR e su altri aspetti della configurazione di TLS/SSL.
- Per saperne di più sulla configurazione degli host virtuali, consulta Configurazione dell'accesso TLS a un'API per il cloud privato.
- Non puoi creare due organizzazioni con lo stesso nome. In questo caso, la seconda creazione non andrà a buon fine.
Per maggiori informazioni sull'utilizzo dell'API di gestione per l'onboarding di un'organizzazione, consulta Creazione di un'organizzazione, un ambiente e un host virtuale.
Verificare l'onboarding
Al termine dell'onboarding, verifica lo stato del sistema inviando i seguenti comandi CURL sul nodo del server di gestione:
- Controlla lo stato degli utenti e dell'organizzazione sul server di gestione eseguendo questi
comandi:
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/org_name/deployments
- Controlla l'analisi eseguendo questo comando:
curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
- Controlla lo stato del database PostgreSQL eseguendo i comandi seguenti sul nodo 2 (come mostrato nelle topologie di installazione):
psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
Al prompt dei comandi, inserisci questo comando per visualizzare la tabella di analisi per la tua organizzazione:
\d analytics."org_name.env_name.fact"
Utilizza il comando seguente per uscire da psql:
\q
- Accedi all'interfaccia utente di Apigee Edge utilizzando un browser web. Ricorda che hai già annotato l'URL della console di gestione alla fine dell'installazione.
- Avvia il tuo browser preferito e inserisci l'URL dell'UI Edge. Ha un aspetto simile al seguente, dove l'indirizzo IP è per il Nodo 1 (come mostrato nelle topologie di installazione) o per il nodo su cui hai installato l'UI per le configurazioni alternative:
http://192.168.56.111:9000/login
9000 è il numero di porta utilizzato dall'interfaccia utente.
Se avvii il browser direttamente sul server che ospita l'UI Edge, puoi utilizzare un URL nel formato:
http://localhost:9000/login
- Nella pagina di accesso della console, specifica il nome utente e la password dell'amministratore di sistema Apigee.
- Avvia il tuo browser preferito e inserisci l'URL dell'UI Edge. Ha un aspetto simile al seguente, dove l'indirizzo IP è per il Nodo 1 (come mostrato nelle topologie di installazione) o per il nodo su cui hai installato l'UI per le configurazioni alternative:
- Registrati per un nuovo account utente Apigee e utilizza la nuova credenziale utente per accedere. Nella pagina di accesso della console, fai clic sul pulsante Accedi.
Il browser reindirizza a
http://192.168.56.111:9000/platform/#/org_name/
e apre una dashboard che ti consente di configurare l'organizzazione che hai creato (se hai eseguito l'accesso utilizzando le credenziali amministratore di Apigee).
Crea il tuo primo proxy
Dopo aver approvato una nuova organizzazione e verificato che il processo di onboarding sia riuscito, puoi creare il tuo primo proxy. Per ulteriori informazioni, consulta l'articolo Creare il primo proxy API.
Altre risorse che potresti trovare utili sono: