Deployment di Spring Cloud Config

Questo documento mostra come eseguire il deployment di Spring Cloud Config in un cluster Kf.

Spring Cloud Config fornisce un modo per disaccoppiare il codice dell'applicazione dalla configurazione di runtime. Il server di configurazione di Spring Cloud Config può leggere i file di configurazione dai repository Git, dal file system locale, dai server HashiCorp Vault o da Cloud Foundry CredHub. Dopo aver letto la configurazione, il server di configurazione può formattare e pubblicare la configurazione come YAML, proprietà Java o JSON su HTTP.

Prima di iniziare

Devi avere un cluster con Kf installato e avere accesso all'interfaccia a riga di comando Kf.

Inoltre, avrai bisogno del seguente software:

  • git: Git è necessario per clonare un repository.

Download del server di configurazione Spring Cloud Config

Per scaricare l'origine del server di configurazione:

  1. Apri un terminale.
  2. Clona l'origine per il server di configurazione:

    git clone --depth 1 "https://github.com/google/kf"
    

Configurare ed eseguire il deployment di un server di configurazione

Per aggiornare le impostazioni dell'istanza:

  1. Cambia directory in spring-cloud-config-server:

    cd kf/spring-cloud-config-server
    
  2. Apri manifest.yaml.

  3. Modifica la variabile di ambiente GIT_URI con l'URI del server di configurazione Git.

  4. Se vuoi, modifica il nome dell'applicazione nel manifest.

  5. Se vuoi, configura proprietà aggiuntive o origini proprietà alternative modificando src/main/resources/application.properties.

  6. Esegui il deployment del server di configurazione senza una route esterna. Se hai modificato il nome dell'applicazione nel file manifest, aggiornalo qui:

    kf push --no-route spring-cloud-config
    

Associazione delle applicazioni al server di configurazione

Puoi creare un servizio fornito dall'utente per associare il server di configurazione di cui è stato eseguito il deployment ad altre applicazioni Kf nello stesso cluster o spazio dei nomi.

La modalità di configurazione dipende dalla libreria che utilizzi:

Applicazioni PCF

Le applicazioni PCF esistenti che utilizzano la libreria client dei servizi Spring Cloud di Pivotal possono essere associate utilizzando il seguente metodo:

  1. Crea un servizio fornito dall'utente denominato config-server. Questo passaggio deve essere eseguito una sola volta per server di configurazione:

    kf cups config-server -p '{"uri":"http://spring-cloud-config"}' -t configuration
    
  2. Per ogni applicazione che richiede credenziali, esegui:

    kf bind-service application-name config-server
    kf restart application-name
    

    Verrà creata una voce nella variabile di ambiente VCAP_SERVICES per il server di configurazione.

Altre applicazioni

Le applicazioni che possono connettersi direttamente a un server di configurazione Spring Cloud Config devono essere configurate per l'accesso utilizzando l'URI interno del cluster:

http://spring-cloud-config
  • Per le applicazioni Spring che utilizzano la libreria client di Spring Cloud Config, puoi impostare la proprietà spring.cloud.config.uri nella posizione appropriata per la tua applicazione. Di solito, si tratta di un file application.properties o application.yaml.
  • Per altri framework, vedi le informazioni di riferimento della tua libreria.

Eliminazione del server di configurazione

Per rimuovere un server di configurazione:

  1. Rimuovi tutte le associazioni al server di configurazione che esegue i seguenti comandi per ogni applicazione associata:

    kf unbind-service application-name config-server
    kf restart application-name
    
  2. Rimuovi la voce di servizio per il server di configurazione:

    kf delete-service config-server
    
  3. Elimina l'applicazione del server di configurazione:

    kf delete spring-cloud-config
    

Passaggi successivi