In questa pagina vengono riportate alcune cose che devi sapere per iniziare a sviluppare un servizio per Cloud Run for Anthos.
Requisiti di codice
Quando sviluppi un servizio, devi soddisfare i seguenti requisiti:
- Il servizio deve ascoltare le richieste.
Puoi configurare la porta su cui inviare le richieste.
All'interno delle istanze del container Cloud Run for Anthos, il valore della variabile di ambiente
PORT
rispecchia sempre la porta a cui vengono inviate le richieste. Il codice deve verificare l'esistenza di questa variabile di ambientePORT
e, se presente, deve ascoltarla per massimizzare la portabilità. - Il servizio deve essere stateless. Non può fare affidamento su uno stato locale persistente.
- Il servizio non deve eseguire attività in background al di fuori dell'ambito della gestione delle richieste.
Ulteriori informazioni su questi vincoli sono disponibili nel Contratto di runtime dei container.
Supporto dei linguaggi di programmazione
Cloud Run for Anthos ti consente di scrivere il codice nel linguaggio di programmazione che preferisci.
Tramite un server web
Puoi utilizzare un server web per ascoltare sulla porta richiesta ed elaborare ed instradare le richieste in entrata. Ad esempio, gli sviluppatori di Node.js possono utilizzare Espresso.js, gli sviluppatori Python possono usare Flask, gli sviluppatori Ruby possono utilizzare Sinatra e così via.
Containerizzazione del codice
Per eseguire il deployment in Cloud Run for Anthos, devi fornire un'immagine container. Un'immagine container è un formato di pacchetto che include il codice, i relativi pacchetti, eventuali dipendenze binarie necessarie, il sistema operativo da utilizzare e qualsiasi altra cosa necessaria per eseguire il servizio.
Il file Dockerfile viene comunemente utilizzato per dichiarare come creare l'immagine container.
Spesso i Dockerfile iniziano da un'immagine di base (ad es. FROM golang:1.11
).
Puoi trovare immagini di base gestite dal sistema operativo e da autori del linguaggio in
Docker Hub. Cloud Build controlla le immagini memorizzate nella cache prima di eseguire il pull da Docker Hub. Se utilizzi uno strumento di build di terze parti, puoi configurare il tuo daemon Docker per verificare la presenza di immagini nella stessa cache. Puoi anche trovare le immagini di base gestite da Google in
Google Cloud Marketplace.
Se utilizzi programmi binari personalizzati, assicurati che siano compilati per Linux ABI x86_64.
Queste risorse forniscono ulteriori informazioni sui Dockerfile:
- Scopri la sintassi tramite il riferimento Docker e come funzionano assieme attraverso i suggerimenti nella sezione Best practice per scrivere Dockerfile
- Leggi le best practice per la creazione di container per ulteriori perfezionamenti
Passaggi successivi
- Una volta ottenuti il codice di servizio e il Dockerfile, devi creare un'immagine container per poi continuare con le iterazioni nei test locali.
- Se esegui la migrazione di un'applicazione web esistente, vedi Migrazione del servizio a Cloud Run for Anthos.
- Per le best practice per progettare, implementare, testare ed eseguire il deployment di un servizio in Cloud Run for Anthos, consulta i suggerimenti per lo sviluppo.