- v1.12 (più recente)
- Versione 1.11
- Versione 1.10
- Elenco delle versioni supportate
- Versione 1.9
- Versione 1.8
- Versione 1.7
- Versione 1.6
- Versione 1.5
- Versione 1.4
- Versione 1.3
- Versione 1.2
- Versione 1.1
Versioni supportate:
Versioni non supportate:
Specifica gli override della configurazione
Il programma di installazione di Apigee hybrid utilizza i valori predefiniti per molte impostazioni; tuttavia, ci sono alcune impostazioni che 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
alla directory$APIGEECTL_HOME
/examplesoverrides
:cp
$APIGEECTL_HOME
/examples/overrides-small.yaml ./overrides/overrides.yamlQuesto file di esempio fornisce una configurazione di base per un'installazione di runtime ibrido di dimensioni ridotte, ovvero una configurazione adatta per la tua prima installazione.
cd
nella directoryoverrides
:- Apri
overrides.yaml
e aggiungi i valori obbligatori della proprietà, mostrati di seguito. Di seguito viene fornita anche una descrizione dettagliata di ogni proprietà:Sintassi
Il file
overrides.yaml
ha la seguente struttura e sintassi. I valori in red, bold italics sono valori della proprietà che devi fornire. Sono descritti nella tabella seguente.gcp: region: gcp-region projectID: gcp-project-id k8sCluster: name: cluster-name region: cluster-region org: org-name virtualhosts: - name: virtual-host-name hostAliases: - "host-alias-1" - "host-alias-2" - "host-alias-n" sslCertPath: ./certs/cert-name.pem sslKeyPath: ./certs/key-name.key routingRules: - paths: - /path-1 - /path-2 - /path-n env: environment-name envs: - name: environment-name # The same name of the env you created in the UI 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: false
Esempio
L'esempio seguente mostra un file di override completato con valori di proprietà di esempio aggiunti:
gcp: region: us-central1 projectID: my-gcp-project k8sCluster: name: apigee-hybrid region: us-central1 org: hybrid-org virtualhosts: - name: default hostAliases: - "*.acme.com" sslCertPath: ./certs/keystore.pem sslKeyPath: ./certs/keystore.key routingRules: # - paths: - env: my-environment envs: - name: test 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: false
- Al termine, salva il file.
cd overrides
La tabella seguente descrive tutti i valori delle proprietà che devi fornire nel file di override. Per maggiori informazioni, consulta Riferimento alla proprietà di configurazione.
Variabile | Descrizione |
---|---|
gcp-region | Identifica la regione Google Cloud
in cui apigee-logger e apigee-metrics eseguono il push dei dati. |
gcp-project-id | Identifica il progetto Google Cloud in cui apigee-logger e apigee-metrics eseguono il push dei dati. |
cluster-name | Il nome del tuo cluster Kubernetes. |
cluster-region | La regione in cui è stato creato il cluster. |
org-name | Il nome della tua organizzazione ibrida Apigee. |
virtual-host-name | Un nome per identificare l'host virtuale. |
host-alias (1 - n) | (Obbligatorio) Un nome DNS qualificato per l'ambiente. Puoi utilizzare un carattere
jolly parziale come |
cert-name key-name |
Inserisci il nome della chiave TLS autofirmata e i file di certificati generati in precedenza nel passaggio
Creare le credenziali TLS per il gateway di runtime. Questi file devono trovarsi nella directory base_directory/hybrid-files/certs . Ad esempio:sslCertPath: ./certs/keystore.pem sslKeyPath: ./certs/keystore.key. |
path (1 - n) | Le regole di routing indirizzano le chiamate API ai percorsi indicati all'ambiente indicato.
Da path-1 a path-n sono i percorsi di base ai proxy API di cui è stato eseguito il deployment
nell'ambiente denominato in environment-name. paths:
è facoltativo. Il percorso predefinito è /. Vedi anche
Configurare gli host virtuali.
paths: non è
obbligatorio. Elimina o commenta paths: e qualsiasi voce del percorso. |
environment-name (meno di routingRules ) |
Questa è la destinazione delle chiamate API dell'ambiente a cui verranno instradate. Utilizza lo stesso nome utilizzato per creare un ambiente nella UI, come spiegato nel Passaggio 5: aggiungi un nuovo ambiente nella UI ibrida. . |
environment-name | Utilizza lo stesso nome utilizzato per creare un ambiente nella UI, come spiegato nel Passaggio 5: aggiungi un nuovo ambiente nella UI ibrida. |
synchronizer-service-account-name | Il nome del file della chiave dell'account di servizio del sincronizzatore che hai generato con lo 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 con lo 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 al nome comune (CN) utilizzato nel certificato TLS autorizzato richiesto per questa configurazione. Ad esempio,
mart.mydomain.com
|
mart-service-account-name | Il nome del file della chiave dell'account di servizio mart che hai generato con lo strumento create-service-account . |
mart-cert-name mart-key-name |
Inserisci il nome della chiave TLS autorizzata e i file di certificati generati 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 delle chiavi dell'account di servizio delle 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 dei componenti ibridi in un cluster. Successivamente, applicherai questa configurazione al cluster.
1 2 3 (AVANTI) Passaggio 4: installa il runtime ibrido