Questa pagina descrive le linee guida per la manutenzione e l'aggiornamento del prodotto dopo la sua pubblicazione su Cloud Marketplace.
Gestire gli aggiornamenti dell'app
La procedura per aggiornare il prodotto è simile alla creazione del pacchetto iniziale dell'app. Innanzitutto, devi generare un nuovo insieme di immagini container per l'aggiornamento ed eseguine il push nel repository di gestione temporanea di Container Registry. A seconda che tu stia aggiungendo una nuova versione o aggiornandone una esistente usa la procedura riportata di seguito per aggiornare l'app.
Aggiunta di una nuova versione
Nel repository di staging di Container Registry, tagga le immagini dell'app con un nuovo tag della versione secondaria. Poi, segui i passaggi per inviare l'app in Producer Portal.
Aggiornamento di una versione esistente
Nel repository di gestione temporanea di Container Registry, contrassegna le immagini con l'attuale tag della versione secondaria. A questo punto, segui i passaggi riportati di seguito per aggiornare l'app nel Producer Portal.
Apri il Producer Portal nella console Google Cloud:
https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID
Sostituisci YOUR_PUBLIC_PROJECT_ID con l'ID per il pubblico creato per Cloud Marketplace, ad esempio
my-organization-public
.Nell'elenco dei prodotti, fai clic sull'ID prodotto.
Nella pagina Panoramica del tuo prodotto, vai alla sezione Immagini contenitore e fai clic su Modifica.
In Versioni proposte, fai clic su Modifica. Potrebbero essere necessari alcuni secondi per leggere il repository e caricare i tag.
Fai clic sulla release che vuoi aggiornare.
In Tag display, seleziona la release che utilizza i valori corrispondenti digest all'immagine che hai aggiornato in Container Registry.
Dopo aver aggiornato tutte le informazioni relative alla release, fai clic su Fine.
Quando hai finito di aggiungere le release supportate al tuo prodotto, fai clic su Salva e convalida.
Fai clic su Invia per inviare le immagini del contenitore per la revisione.
Dopo che tutte le revisioni sono state approvate, puoi pubblicare e lanciare il prodotto aprendo la pagina Panoramica del prodotto e facendo clic su Pubblica.
Come per l'invio iniziale, il team di Cloud Marketplace esegue test automatici e esamina la tua richiesta.
Una volta pubblicata, la versione aggiornata diventa predefinita per i nuovi clienti. I clienti attuali vedranno le nuove immagini caricate nei tag esistenti. I deployment dalla pagina del prodotto del marketplace Cloud sono sempre bloccati nei digest delle immagini e non vengono aggiornati automaticamente. Ti consigliamo inoltre di bloccare le immagini nella sintesi per i clienti che eseguono il deployment della tua app tramite la riga di comando.
Per aiutare gli utenti ad aggiornare le immagini delle app, ti consigliamo di aggiungere i passaggi per l'upgrade alla guida dell'utente.
Migrazione dalle API Kubernetes deprecate
Con l'evoluzione delle API Kubernetes, le API precedenti vengono ritirate e rimosse. Questo significa che la tua app può diventare incompatibile con l'attuale GKE cluster. In genere gli oggetti esistenti vengono mantenuti, pertanto i deployment in esecuzione dei clienti non sono interessati.
Per evitare errori nei deployment di nuove app:
- Rivedi le attuali versioni di GKE in Note di rilascio di GKE e le versioni future in Pianificazione delle release di GKE.
- Aggiorna i manifest dell'app per rimuovere eventuali dipendenze dalle versioni dell'API Kubernetes ritirate che vengono rimosse in qualsiasi versione GKE attuale o futura nel canale regolare o stabile. Consulta la guida alla migrazione delle API ritirate di Kubernetes.
- Ad esempio, aggiorna gli utilizzi di
batch/v1beta1
CronJob
inbatch/v1
, poichébatch/v1beta1
verrà rimosso nella versione 1.25 di Kubernetes, come indicato nella guida. - Se non riesci ad aggiornare i manifest per le release precedenti della tua app, ti consigliamo di rimuoverla o di impostare la
k8sVersion
limitazione del cluster nel tuo schema.
- Ad esempio, aggiorna gli utilizzi di
- Esegui il test completo di tutte le immagini dei container ricostruite utilizzando lo strumento mpdeval, idealmente su un cluster con una versione di Kubernetes che non supporta l'API deprecata che stai rimuovendo.
- Ad esempio, utilizza un cluster Kubernetes versione 1.22 per testare l'aggiornamento dal
apiextensions.k8s.io/v1beta1
CustomResourceDefinition
, che è stato rimosso nella versione 1.22 di Kubernetes.
- Ad esempio, utilizza un cluster Kubernetes versione 1.22 per testare l'aggiornamento dal
- Segui le istruzioni per aggiungere una nuova versione oppure Aggiorna una versione esistente per inviare i tuoi modifiche nel portale.
Modifiche ai prezzi
Le modifiche ai prezzi entrano in vigore dopo un determinato periodo di attesa e non sono nell'immediato. Per informazioni specifiche, fai riferimento al tuo contratto.
Apri il Producer Portal nella console Google Cloud:
https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID
Sostituisci YOUR_PUBLIC_PROJECT_ID con l'ID per il pubblico creato per Cloud Marketplace, ad esempio
my-organization-public
.Nell'elenco dei prodotti, fai clic sull'ID prodotto.
Nella pagina della Panoramica del tuo prodotto, vai a Revisione dei prezzi e fai clic su Modifica.
Apporta le modifiche necessarie ai prezzi.
Fai clic su Invia per inviare i prezzi per la revisione.
Dopo che tutte le revisioni sono state approvate, puoi pubblicare e lanciare il prodotto aprendo la pagina Panoramica del prodotto e facendo clic su Pubblica.
Ritiro delle app
Durante lo sviluppo del software, potresti voler rendere alcune release non disponibili su Cloud Marketplace.
Rimuovere una release dell'app
Quando rimuovi una release dal prodotto, questa viene rimossa immediatamente da pagina dei dettagli del prodotto quando quest'ultimo viene pubblicato. Tuttavia, la rimozione Una release non rimuove le immagini pubblicate per il pubblico e Container Registry.
Apri Producer Portal nella console Google Cloud:
https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID
Sostituisci YOUR_PUBLIC_PROJECT_ID con l'ID per il pubblico creato per Cloud Marketplace, ad esempio
my-organization-public
.Nell'elenco dei prodotti, fai clic sull'ID prodotto.
Nella pagina Panoramica del tuo prodotto, vai alla sezione Immagini contenitore e fai clic su Modifica.
Accanto a Release proposte, fai clic su Modifica. L'operazione potrebbe richiedere alcuni secondi per leggere il repository e caricare i tag.
Evidenzia l'uscita che vuoi rimuovere.
Fai clic su
Elimina per rimuovere la versione.Fai clic su Fine.
Dopo aver rimosso le release per il prodotto, fai clic su Salva e convalida.
Fai clic su Invia per inviare le immagini del contenitore per la revisione.
Dopo che tutte le revisioni sono state approvate, puoi pubblicare e lanciare il prodotto aprendo la pagina Panoramica del prodotto e facendo clic su Pubblica.