Questa pagina è stata tradotta dall'API Cloud Translation.

Passaggio 4: installazione di apigeectl

Questo passaggio spiega come scaricare e installare apigeectl, configurare le directory di installazione e creare account di servizio Google Cloud e credenziali TLS necessarie per il funzionamento di Apigee hybrid.

Scarica e installa `apigeectl`

apigeectl è l'interfaccia a riga di comando (CLI) per l'installazione e la gestione di Apigee hybrid in un cluster Kubernetes.

I passaggi riportati di seguito descrivono come ottenere apigeectl:

Archivia il numero della versione più recente in una variabile utilizzando il seguente comando:
```
export VERSION=$(curl -s \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1)
```
Nota : alcune shell dei terminali di macOS potrebbero restituire un errore da questo comando. Se viene visualizzato un messaggio di errore, prova a eseguire il comando senza ?ignoreCache=1, come segue:
```
export VERSION=$(curl -s \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt)
```
Verifica che la variabile sia stata compilata con un numero di versione utilizzando il seguente comando. Se vuoi utilizzare una versione diversa, puoi salvarla in una variabile di ambiente.
```
echo $VERSION
```
```
  1.4.0
```

Scarica il pacchetto della release per il tuo sistema operativo utilizzando il seguente comando:

Mac a 64 bit:

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_64.tar.gz

Linux a 64 bit:

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_64.tar.gz

Mac a 32 bit:

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_32.tar.gz

Linux a 32 bit:

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_32.tar.gz

Crea una directory sul sistema da utilizzare come directory di base per l'installazione di Apigee hybrid.
Estrai il contenuto del file gzip scaricato nella directory di base appena creata utilizzando seguente comando:
```
tar xvzf filename.tar.gz -C path-to-base-directory
```
Passa alla directory di base utilizzando il comando cd.
Per impostazione predefinita, i contenuti del file tar vengono espansi in una directory con la versione e la piattaforma nel nome. Ad esempio: ./apigeectl_1.4.0-d591b23_linux_64. Rinomina la directory in apigeectl utilizzando il seguente comando:
```
mv apigeectl_1.4.0-d591b23_linux_64 apigeectl
```
Passa alla directory utilizzando il seguente comando:
```
cd ./apigeectl
```
Questa è la home directory apigeectl. È la posizione del comando eseguibile apigeectl.
Crea una variabile di ambiente per contenere il percorso della home directory utilizzando il seguente comando:
```
export APIGEECTL_HOME=$PWD
```
Verifica che la variabile contenga il percorso corretto utilizzando il seguente comando:
```
echo $APIGEECTL_HOME
```

Configura la struttura della directory del progetto

La seguente struttura di directory è un approccio suggerito. Separa il software di rilascio di Apigee hybrid dai file di configurazione che devi creare. Tramite l'uso della variabile $APIGEECTL_HOME e dei link simbolici che crei, puoi passare facilmente a una nuova versione del software, se vuoi. Vedi anche Upgrade di Apigee hybrid.

Assicurati di essere nella directory di base (la directory in cui si trova la directory apigeectl) utilizzando il seguente comando:
```
cd $APIGEECTL_HOME/..
```
Crea una nuova cartella denominata hybrid-files utilizzando il seguente comando. Puoi concedere alla directory il nome che desideri, ma nei documenti viene utilizzato il nome hybrid-files costantemente. Successivamente, archivierai file di configurazione, chiavi degli account di servizio e TLS certificati in questa cartella. Questa cartella ti consente di tenere separati i file di configurazione dall'installazione del software apigeectl.
```
mkdir hybrid-files
```

La struttura attuale della directory è la seguente:

pwd && ls
/hybrid-base-directory
  apigeectl
  hybrid-files

Cambia la directory nella cartella hybrid-files utilizzando il seguente comando:
```
cd hybrid-files
```
All'interno della directory hybrid-files, crea quanto segue sottodirectory per organizzare i file che creerai in seguito:
```
mkdir overrides
mkdir service-accounts
mkdir certs
```
All'interno della directory hybrid-files, crea i seguenti link simbolici a $APIGEECTL_HOME. Questi link ti consentono di eseguire il comando apigeectl dall'interno della directory hybrid-files, come mostrato nell'esempio seguente:
Nota: se non è la prima volta che utilizzi questo processo, i seguenti link simbolici potrebbero già esistere. Verifica se i link esistono già utilizzando il comando seguente. Se le directory esistono, salta questo passaggio.
```
ls -l | grep ^l
```
```
ln -s $APIGEECTL_HOME/tools tools
ln -s $APIGEECTL_HOME/config config
ln -s $APIGEECTL_HOME/templates templates
ln -s $APIGEECTL_HOME/plugins plugins
```
Per verificare che i link simbolici siano stati creati correttamente, esegui il seguente comando e assicurati che i percorsi dei link rimandino alle posizioni corrette:
```
ls -l | grep ^l
```

Ora hai una home page da cui puoi configurare, eseguire il deployment e gestire Apigee hybrid nel tuo cluster Kubernetes. Ora creerai gli account di servizio e le credenziali di Google Cloud. per configurare i componenti di runtime ibridi.

1 2 3 4 (AVANTI) Passaggio 5: configura gli account di servizio 6 7

Passaggio 4: installazione di apigeectl

Scarica e installa apigeectl

Configura la struttura della directory del progetto

Scarica e installa `apigeectl`