Questa pagina è stata tradotta dall'API Cloud Translation.

Passaggio 3: configura il cluster AKS

Specificare le sostituzioni di configurazione

L'installatore di Apigee Hybrid utilizza i valori predefiniti per molte impostazioni. Tuttavia, alcune impostazioni non hanno valori predefiniti. Devi fornire i valori per queste impostazioni, come spiegato di seguito.

Assicurati di essere nella directory hybrid-base-directory/hybrid-files.
Copia il file overrides-small.yaml dalla directory $APIGEECTL_HOME/examples in la tua directory overrides:
```
cp $APIGEECTL_HOME/examples/overrides-small.yaml ./overrides/overrides-aks.yaml
```
Questo file di esempio fornisce una configurazione di base per un'installazione del runtime ibrida con un ingombro ridotto, una configurazione adatta per la prima installazione.
cd nella directory overrides:

cd overrides

Apri overrides-aks.yaml e aggiungi i valori della proprietà obbligatori, come mostrato di seguito. Di seguito è riportata anche una descrizione dettagliata di ogni proprietà:

NOTA: devi attivare esplicitamente la registrazione impostando logger:enabled:true nel file delle sostituzioni.

Sintassi

Il file overrides-aks.yaml ha la seguente struttura e sintassi. I valori in red, bold italics sono valori delle proprietà che devi fornire:

gcpProjectID: project-id
k8sClusterName: aks-cluster-name
org: org-name

envs:
  - name: environment-name  # The same name of the env you created in the UI
    hostAlias: test-host-alias
    sslCertPath: ./certs/test-cert-name.pem
    sslKeyPath: ./certs/test-key-name.key
    serviceAccountPaths:
      synchronizer: ./service-accounts/synchronizer-service-account-name.json
      udca: ./service-accounts/udca-service-account-name.json

mart:
  hostAlias: mart-host-alias
  serviceAccountPath: ./service-accounts/mart-service-account-name.json
  sslCertPath: ./certs/mart-cert-name.pem
  sslKeyPath: ./certs/mart-key-name.key

metrics:
  serviceAccountPath: ./service-accounts/metrics-service-account-name.json

logger:
  enabled: true

Esempio

L'esempio seguente mostra un file di override completati con valori di proprietà di esempio aggiunto:

gcpProjectID: hybrid-project
k8sClusterName: apigee-hybrid
org: hybrid-org

envs:
  - name: test
    hostAlias: "*"
    sslCertPath: ./certs/keystore.pem
    sslKeyPath: ./certs/keystore.key
    serviceAccountPaths:
      synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json
      udca: ./service-accounts/hybrid-project-apigee-udca.json

mart:
  hostAlias: "mart.apigee-hybrid-docs.net"
  serviceAccountPath: ./service-accounts/hybrid-project-apigee-mart.json
  sslCertPath: ./certs/fullchain.pem
  sslKeyPath: ./certs/privkey.key

metrics:
      serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json

logger:
  enabled: true

Al termine, salva il file.

La seguente tabella descrive tutti i valori della proprietà che devi specificare nel esegue l'override del file.

Variabile	Descrizione
`project-id`	L'ID del tuo progetto Google Cloud.
`aks-cluster-name`	Il nome del cluster Kubernetes AKS.
`org-name`	Il nome della tua organizzazione Apigee hybrid.
`environment-name`	Utilizza lo stesso nome che hai utilizzato per la creazione di un ambiente nella UI, come spiegato nel Passaggio 5: aggiungi un nuovo ambiente nella UI ibrida.
`test-host-alias`	(Obbligatorio) Per la guida rapida, utilizza il carattere jolly "``". L'utilizzo di `` è consigliato solo per un'installazione di prova quando si utilizzano credenziali TLS autofirmate. In seguito, quando sviluppi configurazioni ibride Apigee più complesse, ad esempio la creazione di più ambienti, dovrai utilizzare un nome di dominio qualificato per questo valore.
`test-cert-name` `test-key-name`	Inserisci il nome della chiave TLS autofirmata e dei file dei certificati che hai generato in precedenza nel passaggio Crea le credenziali TLS per il gateway di runtime. Questi file devono trovarsi in nella directory `base_directory/hybrid-files/certs`. Ad esempio: sslCertPath: ./certs/keystore.pem sslKeyPath: ./certs/keystore.key
`synchronizer-service-account-name`	Il nome del file della chiave dell'account di servizio della sincronizzazione che hai generato con Strumento `create-service-account`. Ad esempio: synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json
`udca-service-account-name`	Il nome del file della chiave dell'account di servizio udca che hai generato Strumento `create-service-account`. Ad esempio: udca: ./service-accounts/hybrid-project-apigee-udca.json
`mart-host-alias`	Un nome DNS qualificato per l'endpoint del server MART. Questo nome deve corrispondere il nome comune (CN) utilizzato nel certificato TLS autorizzato richiesto per questa configurazione. Ad esempio: `mart.mydomain.com` NOTA: il nome comune (CN) nel certificato deve essere in linea con il valore specificato nella proprietà `mart.hostAlias`. Se il nome di rete è `*.hybrid-domain.net` e hai registrato l'host `mart.hybrid-domain.net`, dovrai impostare `mart.hostAlias` al valore `mart.hybrid-domain.net`.
`mart-service-account-name`	Il nome del file della chiave dell'account di servizio del marketplace che hai generato con lo strumento `create-service-account`.
`mart-cert-name` `mart-key-name`	Inserisci il nome dei file della chiave e del certificato TLS autorizzati che hai generato in precedenza nel passaggio Crea le credenziali TLS per il gateway MART. Questi file devono trovarsi nella directory `base_directory/hybrid-files/certs`. Ad esempio: sslCertPath: ./certs/fullchain.pem sslKeyPath: ./certs/privkey.key
`metrics-service-account-name`	Il nome del file della chiave dell'account di servizio per le metriche che hai generato con lo strumento `create-service-account`. Ad esempio: serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json

Riepilogo

Il file di configurazione indica a Kubernetes come eseguire il deployment in un cluster. Successivamente, dovrai applicare questa configurazione al tuo cluster.

1 2 3 (AVANTI) Passaggio 4: installa il runtime ibrido