Questa pagina descrive come modellare e pacchettizzare le unità di deployment per un'offerta SaaS. In Runtime SaaS, un'unità di deployment è chiamata tipo di unità.
Crea un tipo di unità per ogni componente dell'offerta SaaS che vuoi gestire in modo indipendente. Per ulteriori dettagli, consulta la sezione seguente Determinare il modello dell'offerta SaaS.
Se vuoi, puoi creare un'offerta SaaS utilizzando un unico tipo di unità per l'intera offerta SaaS.
I tipi di unità sono definiti da un progetto iniziale, ovvero una configurazione Terraform pacchettizzata come immagine OCI. Prima di creare un tipo di unità, devi creare un blueprint per ogni tipo di unità. Per informazioni dettagliate sulla creazione di blueprint, vedi Creare e caricare un blueprint.
Prima di iniziare
- Assicurati di aver definito un'offerta SaaS per la tua applicazione SaaS.
- Assicurati di aver creato un repository Artifact Registry.
- Assicurati di disporre dei service account con le autorizzazioni richieste. Per maggiori dettagli, vedi Service account Runtime SaaS.
- Per ogni tipo di unità che crei, assicurati di avere una configurazione Terraform e di aver preparato il progetto. Per maggiori dettagli, consulta la sezione seguente Determinare il modello dell'offerta SaaS.
Determina il modello dell'offerta SaaS
Per modellare l'offerta SaaS, devi determinare quanti tipi di unità creare e la relazione tra questi tipi di unità.
Ad esempio, puoi creare due tipi di unità: uno per l'infrastruttura, ad esempio una VM, e uno per l'applicazione di cui è stato eseguito il deployment sull'infrastruttura. Se vuoi, puoi creare un'offerta SaaS utilizzando un solo tipo di unità per l'intera offerta SaaS.
Per decidere come modellare l'offerta SaaS utilizzando i tipi di unità, considera quanto segue:
- Esamina le dipendenze tra i componenti dell'offerta SaaS. Ad esempio, se un'offerta SaaS include un'applicazione di cui è stato eseguito il deployment in un cluster Kubernetes condiviso, valuta la possibilità di utilizzare un tipo di unità per modellare questo cluster condiviso.
- Considera il ciclo di rilascio e manutenzione dei componenti dell'offerta SaaS. Se ci sono componenti gestiti insieme, come l'infrastruttura, valuta la possibilità di modellarli con un solo tipo di unità.
Una volta determinato questo modello, devi creare un blueprint per ogni tipo di unità. Per farlo, devi:
- Identifica la configurazione Terraform per connetterti a questo tipo di unità. Per maggiori dettagli sulle configurazioni Terraform necessarie, consulta Blueprint in Runtime SaaS.
- Assicurati che la configurazione Terraform sia pacchettizzata come immagine OCI e che sia stata eseguito il push in Artifact Registry oppure che si trovi in un archivio zip o in un repository Git. Per maggiori dettagli, vedi Creare e caricare un blueprint.
Quando hai un progetto per ogni tipo di unità, puoi seguire le istruzioni riportate in questa pagina per creare i tipi di unità.
Crea un tipo di unità
Puoi creare un tipo di unità utilizzando una configurazione Terraform fornita nei seguenti modi:
- In un archivio zip.
- In un repository Git.
- Pacchettizzato come immagine OCI.
Creare un tipo di unità utilizzando un archivio zip
Per creare un tipo di unità utilizzando una configurazione Terraform in un archivio zip, completa le seguenti istruzioni.
Per informazioni dettagliate sulla preparazione di un archivio zip, vedi Caricare un archivio zip.
Per creare un tipo di unità:
Nella console, vai a SaaS Runtime > Tipi di unità.
Seleziona Crea.
Per Crea blueprint, seleziona Carica per caricare un archivio zip che contiene la configurazione di Terraform.
Fai clic su Sfoglia e trova l'archivio zip con la configurazione Terraform che definisce le risorse o l'applicazione che fa parte di questo tipo di unità.
Fai clic su Avanti: configura il progetto iniziale.
Nella pagina Archivia il progetto iniziale:
In Seleziona repository da Artifact Registry, fai clic su Sfoglia e seleziona il repository che hai creato.
In Nome immagine artefatto, inserisci un nome per l'immagine OCI.
Per Versione Terraform di Infrastructure Manager, seleziona la versione di Terraform da utilizzare per i deployment. Per un elenco delle versioni di Terraform supportate, consulta Versioni di Terraform supportate.
Per il service account Cloud Build, seleziona il service account che dispone delle autorizzazioni per creare l'immagine. Per maggiori dettagli, vedi Service account per la creazione di artefatti.
Fai clic su Avanti: dettagli del tipo di unità.
Nella pagina Configura le proprietà del tipo di unità, segui questi passaggi:
In Nome tipo di unità, inserisci un nome per il tipo di unità. Il nome deve contenere solo lettere minuscole, numeri o trattini.
Per Offerta SaaS, seleziona l'offerta SaaS che vuoi associare a questo tipo di unità.
Per Dipendenze:
Se si tratta del primo o dell'unico tipo di unità che stai creando per l'offerta SaaS, non aggiungere una dipendenza.
Se hai creato altri tipi di unità che dipendono da questo tipo di unità, seleziona Aggiungi dipendenza.
Per Tipo di unità, seleziona il tipo di unità esistente che dipende dal tipo di unità che stai creando.
In Alias, digita un nome che puoi utilizzare per la mappatura delle variabili di input.
Fai clic su Fine.
Se vuoi definire la mappatura delle variabili, segui questi passaggi. Per informazioni dettagliate sulla mappatura delle variabili, vedi Mappatura delle variabili.
Seleziona Definisci mappature delle variabili di input e output.
Per Mapping delle variabili di input:
- Seleziona Aggiungi mappatura delle variabili di input.
- In Variabile, digita il nome della variabile di input.
- Per Tipo di mappatura, seleziona:
- Da per mappare dall'altro tipo di unità.
- A per mappare l'altro tipo di unità.
- Per Dipendenza, seleziona il tipo di unità esistente a cui stai mappando le variabili.
- Per Variabile di output, digita il nome della variabile di output.
- Seleziona Fine.
Per aggiungere un'altra variabile di input, seleziona Aggiungi mappatura delle variabili di input e ripeti i passaggi.
Per aggiungere mappature delle variabili di output:
- Seleziona la scheda Mapping delle variabili di output.
- Seleziona Aggiungi mappatura delle variabili di output e ripeti i passaggi che hai seguito per la mappatura delle variabili di input.
Fai clic su Avanti: configurazione della release.
In Nome release, digita un nome per la release.
(Facoltativo) Aggiungi un'etichetta alle risorse che stai eseguendo il deployment. Per maggiori dettagli sulle etichette, consulta la Panoramica delle etichette.
Per aggiungere un'etichetta:
Nella sezione Etichette, seleziona Aggiungi etichette.
Per Chiave 1 e Valore 1, inserisci la coppia chiave-valore che preferisci.
Ripeti i passaggi per ogni etichetta che vuoi aggiungere.
Fai clic su Crea.
Ora hai creato un tipo di unità. Per creare un altro tipo di unità, ripeti gli stessi passaggi e utilizza l'archivio zip che contiene la configurazione Terraform per questo tipo di unità successivo.
Se hai creato tutti i tipi di unità necessari per l'offerta SaaS, puoi eseguire il deployment di un'istanza di unità.
Creare un tipo di unità utilizzando un repository Git
Per creare un tipo di unità utilizzando una configurazione Terraform che si trova in un repository Git, completa le seguenti istruzioni.
Per informazioni dettagliate sull'utilizzo di un repository Git per i file Terraform, consulta Connettersi a un repository Git.
Nella console, vai a SaaS Runtime > Tipi di unità.
Seleziona Crea.
In Crea progetto, seleziona Collega repository esterno.
In Repository, seleziona il repository Git con la configurazione Terraform:
Se il repository Git è collegato, selezionalo dall'elenco.
Se il repository non è collegato, fai clic su Collega nuovo repository per utilizzare Developer Connect per collegarlo.
Seleziona Crea nuova connessione.
Per Regione, seleziona una regione per la connessione Developer Connect. Ti consigliamo di utilizzare la stessa regione del repository Artifact Registry.
(Facoltativo) Per la chiave KMS, puoi specificare una chiave KMS per la crittografia.
Per Branch, specifica il ramo Git che contiene la configurazione Terraform che vuoi associare a questo tipo di unità.
Nella pagina Archivia il progetto iniziale:
Per Seleziona repository da Artifact Registry, fai clic su Sfoglia e seleziona il repository Artifact Registry che utilizzi per l'offerta SaaS.
In Nome immagine artefatto, inserisci un nome per l'immagine OCI.
Per Versione Terraform di Infrastructure Manager, seleziona la versione di Terraform da utilizzare per i deployment. Per un elenco delle versioni di Terraform supportate, consulta Versioni di Terraform supportate.
Per il service account Cloud Build, seleziona il service account che dispone delle autorizzazioni per creare l'immagine. Per maggiori dettagli, vedi Service account per la creazione di artefatti.
Fai clic su Avanti: dettagli del tipo di unità.
Nella pagina Configura le proprietà del tipo di unità, segui questi passaggi:
In Nome tipo di unità, inserisci un nome per il tipo di unità. Il nome deve contenere solo lettere minuscole, numeri o trattini.
Per Offerta SaaS, seleziona l'offerta SaaS che vuoi associare a questo tipo di unità.
Per Dipendenze:
Se si tratta del primo o dell'unico tipo di unità che stai creando per l'offerta SaaS, non aggiungere una dipendenza.
Se hai creato altri tipi di unità che dipendono da questo tipo di unità, seleziona Aggiungi dipendenza.
Per Tipo di unità, seleziona il tipo di unità esistente che dipende dal tipo di unità che stai creando.
In Alias, digita un nome che puoi utilizzare per la mappatura delle variabili di input.
Fai clic su Fine.
Se vuoi definire la mappatura delle variabili, segui questi passaggi. Per informazioni dettagliate sulla mappatura delle variabili, vedi Mappatura delle variabili.
Seleziona Definisci mappature delle variabili di input e output.
Per Mapping delle variabili di input:
- Seleziona Aggiungi mappatura delle variabili di input.
- In Variabile, digita il nome della variabile di input.
- Per Tipo di mappatura, seleziona:
- Da per mappare dall'altro tipo di unità.
- A per mappare l'altro tipo di unità.
- Per Dipendenza, seleziona il tipo di unità esistente a cui stai mappando le variabili.
- Per Variabile di output, digita il nome della variabile di output.
- Seleziona Fine.
Per aggiungere un'altra variabile di input, seleziona Aggiungi mappatura delle variabili di input e ripeti i passaggi.
Per aggiungere mappature delle variabili di output:
- Seleziona la scheda Mapping delle variabili di output.
- Seleziona Aggiungi mappatura delle variabili di output e ripeti i passaggi che hai seguito per la mappatura delle variabili di input.
Fai clic su Avanti: configurazione della release.
In Nome release, digita un nome per la release.
(Facoltativo) Aggiungi un'etichetta alle risorse che stai eseguendo il deployment. Per maggiori dettagli sulle etichette, consulta la Panoramica delle etichette.
Per aggiungere un'etichetta:
Nella sezione Etichette, seleziona Aggiungi etichette.
Per Chiave 1 e Valore 1, inserisci la coppia chiave-valore che preferisci.
Ripeti i passaggi per ogni etichetta che vuoi aggiungere.
Fai clic su Crea.
Ora hai creato un tipo di unità. Per creare un altro tipo di unità, ripeti gli stessi passaggi e utilizza il repository Git che contiene la configurazione Terraform per questo tipo di unità successivo.
Se hai creato tutti i tipi di unità necessari per l'offerta SaaS, puoi eseguire il deployment di un'istanza di unità.
Crea un tipo di unità utilizzando un'immagine esistente
Per creare un tipo di unità utilizzando un blueprint esistente, ovvero un'immagine OCI, completa le seguenti istruzioni.
Per informazioni dettagliate sulla creazione di un'immagine OCI, vedi:
Nella console, vai a SaaS Runtime > Tipi di unità.
Seleziona Crea.
Per Crea progetto iniziale, seleziona Seleziona un'immagine esistente da Artifact Registry.
Fai clic su Avanti: configura il progetto iniziale.
Nella pagina Archivia il progetto iniziale:
Per Seleziona o inserisci un progetto iniziale esistente da Artifact Registry:
Fai clic su Sfoglia
Vai all'immagine che contiene la configurazione Terraform.
Fai clic su Seleziona.
Fai clic su Avanti: dettagli del tipo di unità.
Nella pagina Configura le proprietà del tipo di unità, segui questi passaggi:
In Nome tipo di unità, inserisci un nome per il tipo di unità. Il nome deve contenere solo lettere minuscole, numeri o trattini.
Per Offerta SaaS, seleziona l'offerta SaaS che vuoi associare a questo tipo di unità.
Per Dipendenze:
Se si tratta del primo o dell'unico tipo di unità che stai creando per l'offerta SaaS, non aggiungere una dipendenza.
Se hai creato altri tipi di unità che dipendono da questo tipo di unità, seleziona Aggiungi dipendenza.
Per Tipo di unità, seleziona il tipo di unità esistente che dipende dal tipo di unità che stai creando.
In Alias, digita un nome che puoi utilizzare per la mappatura delle variabili di input.
Fai clic su Fine.
Se vuoi definire la mappatura delle variabili, segui questi passaggi. Per informazioni dettagliate sulla mappatura delle variabili, vedi Mappatura delle variabili.
Seleziona Definisci mappature delle variabili di input e output.
Per Mapping delle variabili di input:
- Seleziona Aggiungi mappatura delle variabili di input.
- In Variabile, digita il nome della variabile di input.
- Per Tipo di mappatura, seleziona:
- Da per mappare dall'altro tipo di unità.
- A per mappare l'altro tipo di unità.
- Per Dipendenza, seleziona il tipo di unità esistente a cui stai mappando le variabili.
- Per Variabile di output, digita il nome della variabile di output.
- Seleziona Fine.
Per aggiungere un'altra variabile di input, seleziona Aggiungi mappatura delle variabili di input e ripeti i passaggi.
Per aggiungere mappature delle variabili di output:
- Seleziona la scheda Mapping delle variabili di output.
- Seleziona Aggiungi mappatura delle variabili di output e ripeti i passaggi che hai seguito per la mappatura delle variabili di input.
Fai clic su Avanti: configurazione della release.
In Nome release, digita un nome per la release.
(Facoltativo) Aggiungi un'etichetta alle risorse che stai eseguendo il deployment. Per maggiori dettagli sulle etichette, consulta la Panoramica delle etichette.
Per aggiungere un'etichetta:
Nella sezione Etichette, seleziona Aggiungi etichette.
Per Chiave 1 e Valore 1, inserisci la coppia chiave-valore che preferisci.
Ripeti i passaggi per ogni etichetta che vuoi aggiungere.
Fai clic su Crea.
Ora hai creato un tipo di unità. Per creare un altro tipo di unità, ripeti gli stessi passaggi e utilizza l'immagine OCI che contiene la configurazione Terraform per questo tipo di unità successivo.
Se hai creato tutti i tipi di unità necessari per l'offerta SaaS, puoi eseguire il deployment di un'istanza di unità.
Passaggi successivi
- Dopo aver modellato l'offerta SaaS, puoi eseguire il deployment di un'istanza di unità.
- Per saperne di più su Runtime SaaS, consulta la panoramica di Runtime SaaS.
- Per ulteriori dettagli sui service account necessari quando utilizzi Runtime SaaS, consulta Service account.