Per velocizzare lo sviluppo locale in Cloud Code per Cloud Shell, sfrutta il vantaggio sincronizzazione e ricaricamento a caldo, deployment automatico al momento del salvataggio e utilizzo dei moduli Skaffold per sviluppare parti di un'applicazione separatamente.
Attiva la sincronizzazione dei file Skaffold e il ricaricamento a caldo
Per migliorare l'efficienza del flusso di lavoro di sviluppo locale ed evitare di dover ricostruire, eseguire nuovamente il deployment e riavviare i pod, Skaffold supporta la copia dei file modificati in un contenitore di cui è stato eseguito il deployment. Ciò significa che quando apporti modifiche e file di codice sorgente, puoi vedere le modifiche applicate in pochi secondi, velocizzando ciclo di feedback.
Per i file statici (come i file HTML e CSS), questo comportamento di copia dei file è chiamato sincronizzazione dei file.
Per i file di codice sorgente, questo comportamento è chiamato ricaricamento a caldo e supporta i seguenti tipi di file:
- Vai: *.go
- Java: *.java, *.kt, *.scala, *.groovy, *.clj
- NodeJS: *.js, *.mjs, *.tasse, *.litkids, *.json
Con la ricarica rapida configurata, Skaffold rileva le modifiche ai file supportati e le sincronizza con il contenitore in esecuzione nel cluster. Modifiche ai tipi di file che non supportano i video a caldo il ricaricamento attiva la ricompilazione di un'immagine e il riavvio del pod.
La sincronizzazione automatica dei file e il ricaricamento a caldo sono abilitate per impostazione predefinita
usare Buildpacks
come builder preferito. Per altri builder come
Docker, puoi specificare una sezione sync
nel file skaffold.yaml
per
l'artefatto che stai personalizzando.
L'impostazione di sincronizzazione può essere una delle seguenti (in ordine di preferenza):
auto
: Skaffold configura automaticamente la sincronizzazione. (solo per Jib e Buildpack artifacts.) Questa è l'impostazione predefinita per i Buildpack.infer
: le destinazioni per ogni file modificato vengono dedotte dallo strumento di creazione.manual
: devi specificare i file nella tua area di lavoro locale e la relativa destinazione nel contenitore in esecuzione.
La seguente sezione sync
di esempio in un file skaffold.yaml
specifica una sincronizzazione manual
per sincronizzare tutti i file HTML /static-html
con la cartella static
in un contenitore:
build: artifacts: - image: gcr.io/k8s-skaffold/node-example context: node sync: manual: - src: 'static-html/*.html' dest: static
Per informazioni dettagliate sulla sincronizzazione dei file e sulla specifica delle regole di sincronizzazione, vedi Guida Skaffold per la sincronizzazione dei file.
Aggiungere nuove funzionalità durante lo sviluppo su Kubernetes
Dopo aver configurato la sincronizzazione dei file e il ricaricamento rapido, avvia un ciclo di iterazione e aggiungi altre funzionalità al tuo progetto. Il deployment delle modifiche viene eseguito in Kubernetes senza interrompere e rimuovere il deployment, creando manualmente e il tagging dell'immagine o l'aggiornamento del cluster.
Un ciclo di iterazione standard è simile al seguente:
Apporta una modifica al progetto. Ad esempio, se utilizzi app Cloud Code Java Guestbook, aggiungi un nuovo endpoint
FrontendController
corso come segue:Apri il file
FrontendController.java
dasrc/main/java/cloudcode/guestbook/frontend
e aggiungi quanto segue:@RequestMapping("/greeting") @ResponseBody public String greeting(@RequestParam(value="name", defaultValue="World") String name) { return String.format("Hello from Kubernetes with IntelliJ, %s!", name); }
Aggiungi le importazioni necessarie per le nuove annotazioni,
RequestMapping
eResponseBody
.
Salva le modifiche (
Ctrl
/Cmd+S
) o crea il progetto.Puoi visualizzare i log di avanzamento e deployment nella finestra della console. Dopo aver eseguito il deployment delle modifiche, conferma gli aggiornamenti.
Per terminare la sessione di sviluppo continuo, fai clic sull'icona Interrompi.
Cloud Code elimina tutte le risorse Kubernetes utilizzate per la sessione di sviluppo.
Sviluppare applicazioni di microservizi utilizzando le configurazioni Skaffold
Quando sviluppi applicazioni di microservizi, può essere utile lavorare su sezioni separate in modo indipendente per semplificare il debug e il deployment.
Puoi sviluppare e eseguire il debug di parti della tua applicazione in modo indipendente dividendola in moduli Skaffold. Ad esempio, l'esempio
Bank of Anthos
è un'applicazione contenente dieci microservizi. Il file
skaffold.yaml
del campione raggruppa questi servizi in cinque moduli Skaffold denominati setup
, db
,
frontend
, backend
e loadgenerator
.
Definizione dei moduli Skaffold e delle dipendenze di configurazione
Per definire i moduli Skaffold e le dipendenze della configurazione:
Apri il progetto in cui vuoi definire i moduli.
Apri il file
skaffold.yaml
.Se il file
skaffold.yaml
ha più configurazioni, per creare un configurare un modulo Skaffold, specifica la riga seguente:metadata: name: MODULE_NAME_1
Ad esempio, in Bank of Anthos
skaffold.yaml
, il modulodb
definisce i deployment dei database:Per le configurazioni che richiedono il deployment di un'altra configurazione prima di poter eseguire il deployment della configurazione corrente, devi aggiungere la configurazione alle dipendenze. Per specificare una dipendenza di configurazione, aggiungi un elenco
configs
alla sezionerequires
del fileskaffold.yaml
.Ad esempio, il file Bank of Anthos
skaffold.yaml
include la dipendenza di configurazionesetup
.Per definire una dipendenza, aggiungi quanto segue al file
skaffold.yaml
dove DEPENDENCY_NAME è il nome della dipendenza.requires: - configs: DEPENDENCY_NAME
Le configurazioni elencate in questo modo possono fare riferimento alle dipendenze definite nel stesso file o altri file
skaffold.yaml
nel progetto corrente.Testa le dipendenze della configurazione creando ciascuno degli Skaffold separatamente per assicurarti che il deployment venga eseguito di dipendenze seguendo i passaggi Creare moduli Skaffold specifici e le loro dipendenze.
Crea moduli Skaffold specifici e le relative dipendenze
Dopo aver definito i moduli e le loro dipendenze, puoi specificare quali
moduli da eseguire con Cloud Code nel file launch.json
.
Se per il tuo progetto non è stato definito un file launch.json
, quando esegui Cloud
Code: Esegui su Kubernetes o Cloud Code: Debug su Kubernetes,
viene richiesto di selezionare i moduli da creare:
- Apri la tavolozza dei comandi (
Ctrl
/Cmd
+Shift
+P
) ed esegui Cloud Codice: esegui su Kubernetes. - Fai clic su Seleziona moduli.
- Scegli i moduli di cui vuoi eseguire il deployment e fai clic su OK. Ogni modulo viene creato con le relative dipendenze.
- Quando richiesto, scegli un registro di immagini, quindi premi
Enter
.
Se il tuo progetto ha un file launch.json
, segui questi passaggi per scegliere i moduli Skaffold da compilare:
Apri il file
launch.json
del progetto.Modifica la configurazione di lancio per aggiungere l'opzione
skaffoldFlags
con un elenco delimitato da virgole dimodules
da compilare. SeskaffoldFlags
viene omesso, vengono creati tutti i moduli.{ "name": "Run on Kubernetes", "type": "cloudcode.kubernetes", "request": "launch", "skaffoldConfig": "${workspaceFolder}/skaffold.yaml", "skaffoldFlags": { "modules": ["MODULE_NAME_2,MODULE_NAME_2"], "watch": true, "cleanUp": true, } }
Esegui la configurazione di lancio che hai modificato.
Sviluppo continuo su Kubernetes
Dopo aver configurato il target di esecuzione con le opzioni che preferisci, puoi optare per un'esecuzione regolare dell'applicazione o avviare un ciclo di iterazione di sviluppo nell'IDE per propagare eventuali modifiche apportate al codice sorgente e alle dipendenze all'applicazione in produzione.
La destinazione di esecuzione Esegui su Kubernetes avvia il ciclo di sviluppo sul tuo in un cluster Kubernetes. Dopo aver avviato il ciclo di sviluppo, Cloud Code, utilizzando Skaffold, crea un'immagine per il progetto, poi la tagga, la esegue push nel repository configurato e utilizza kubectl per eseguire il deployment dei manifest Kubernetes del progetto.
- Personalizza il deployment utilizzando opzioni di configurazione disponibili.
- Se la tua applicazione è configurata per utilizzare moduli Skaffold, puoi seleziona moduli specifici di cui creare o eseguire il deployment.
- Apri la tavolozza dei comandi (premi
Ctrl
/Cmd
+Shift
+P
) ed esegui il comando Cloud Code: Esegui su Kubernetes. - Conferma se utilizzare il contesto Kubernetes corrente per eseguire l'app (o passa a quello che preferisci). Per ulteriori informazioni per configurare un contesto Kubernetes, l'impostazione della configurazione.
Se hai scelto un cluster remoto come contesto, quando richiesto, scegli un registry di immagini a cui inviare le immagini. Se utilizzi Container Registry, puoi accedere a un registry esistente o specificare il nome di un registry da creare. Se il tuo progetto ha API Artifact Registry abilitata e almeno in un repository Artifact Registry, può sfogliare e selezionare un repository Artifact Registry esistente.
Cloud Code crea i container, ne esegue il push al registry applica le configurazioni Kubernetes al cluster e attende l'implementazione.
Passaggi successivi
- Usa la tecnologia integrata di Cloud Code cluster minikube per lo sviluppo locale.
- Eseguire il debug dell'applicazione in Cloud Code
- Leggi i dettagli sulla funzionalità di sincronizzazione dei file di Skaffold