Questa pagina è stata tradotta dall'API Cloud Translation.

Eseguire l'onboarding di un'organizzazione

Edge for Private Cloud v4.19.01

Per eseguire l'onboarding di un'organizzazione, devi creare un file di configurazione dell'onboarding e poi passarlo al comando setup-org. Ogni passaggio è descritto nelle sezioni seguenti.

Per informazioni sull'utilizzo dell'API di gestione per l'onboarding di un'organizzazione, consulta Creazione di un'organizzazione, un ambiente e un host virtuale.

Crea un file di configurazione di onboarding

Questa sezione include un file di configurazione di esempio per l'onboarding di un'organizzazione con setup-org.

Copia l'esempio seguente e modificalo in base alle esigenze della 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.

Tieni presente che:

Per VHOST_ALIAS, se hai già un record DNS che utilizzerai per accedere all'host virtuale, specifica l'alias dell'host e, facoltativamente, la porta, ad esempio "myapi.example.com". Se non disponi ancora di un record DNS, puoi utilizzare l'indirizzo IP del router.

Per saperne di più sulla configurazione dell'host virtuale, vedi Configurare un host virtuale.
Per la configurazione TLS/SSL, consulta Archiviatori chiavi e archivi attendibili 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 ulteriori informazioni sulla configurazione di 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.

Esegui setup-org

Dopo aver creato il file di configurazione di onboarding, lo passi allo script setup-org per eseguire la procedura di onboarding. Devi eseguire lo script sul nodo Server di gestione.

Durante l'onboarding di un'organizzazione, lo script setup-org esegue le seguenti operazioni:

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 lo stesso dell'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.
Attiva i dati e le analisi.

Per eseguire setup-org:

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 e puntalo sul file di configurazione che hai creato al passaggio Creare un file di configurazione di onboarding:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
```
Il file di configurazione deve essere leggibile dall'utente "apigee".
Verifica di aver eseguito correttamente 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 di Edge.

Per ulteriori passaggi di verifica, vedi Verificare l'onboarding.
Crea il tuo primo proxy.

Verifica l'onboarding

Al termine dell'onboarding, verifica lo stato del sistema emettendo i seguenti comandi curl sul nodo del server di gestione:

Controlla lo stato dell'utente e dell'organizzazione sul server di gestione eseguendo i seguenti 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 i dati esegui il seguente 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 seguenti comandi 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"
```
Usa questo comando 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 al termine dell'installazione.
1. Avvia il browser che preferisci e inserisci l'URL dell'interfaccia utente di Edge. Ha un aspetto simile al seguente, dove l'indirizzo IP è relativo al Nodo 1 (come mostrato nelle topologie di installazione) o al nodo su cui hai installato l'interfaccia utente 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'interfaccia utente di Edge, puoi utilizzare un URL nel seguente formato:
```
http://localhost:9000/login
```
  Nota: assicurati che la porta 9000 sia aperta. Se utilizzi un servizio come Google Cloud Engine, potresti dover modificare le regole firewall in modo da poter accedere ai servizi Apigee tramite un browser.
2. Nella pagina di accesso della console, specifica il nome utente e la password dell'amministratore di sistema Apigee.
  Nota: si tratta della password dell'amministratore di sistema globale impostata durante l'installazione.
Registra un nuovo account utente Apigee e utilizza le nuove credenziali utente per accedere. Nella pagina di accesso alla 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 di amministratore di Apigee).

Crea il tuo primo proxy

Dopo aver eseguito l'onboarding di una nuova organizzazione e verificato l'esito positivo del processo, ora puoi creare il tuo primo proxy. Per ulteriori informazioni, consulta Creare il tuo primo proxy API.

Altre risorse che potrebbero esserti utili includono: