Manutenzione del prodotto

Questa pagina descrive le linee guida per la manutenzione e l'aggiornamento del prodotto dopo la sua pubblicazione su Cloud Marketplace.

Gestire gli aggiornamenti della tua app

La procedura per aggiornare il prodotto è simile alla creazione del pacchetto dell'app iniziale. Innanzitutto, devi generare un nuovo set di immagini container per l'aggiornamento ed eseguirne il push nel repository di staging di Container Registry. A seconda che tu stia aggiungendo una nuova versione o aggiornandone una esistente, segui i passaggi riportati 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 staging di Container Registry, tagga le immagini con il tag della versione secondaria corrente. A questo punto, segui i passaggi riportati di seguito per aggiornare l'app nel Producer Portal.

  1. 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 del progetto pubblico che hai creato per Cloud Marketplace, ad esempio my-organization-public.

  2. Nell'elenco dei prodotti, fai clic sull'ID prodotto.

  3. Nella pagina della Panoramica del tuo prodotto, vai alla sezione Immagini contenitore e fai clic su Modifica.

  4. In Versioni proposte, fai clic su Modifica. Potrebbero essere necessari alcuni secondi per leggere il repository e caricare i tag.

  5. Fai clic sulla release che vuoi aggiornare.

  6. In Tag di visualizzazione, seleziona la release che utilizza il digest corrispondente all'immagine che hai aggiornato in Container Registry.

  7. Dopo aver aggiornato tutte le informazioni relative alla release, fai clic su Fine.

  8. Quando hai finito di aggiungere le release supportate al prodotto, fai clic su Salva e convalida.

  9. Fai clic su Invia per inviare le immagini del contenitore per la revisione.

  10. 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 nei digest per i clienti che eseguono il deployment dell'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 ritirate

Con l'evoluzione delle API Kubernetes, le API precedenti vengono ritirate e rimosse. Ciò significa che la tua app può diventare incompatibile con i cluster GKE attuali. In genere gli oggetti esistenti vengono mantenuti, pertanto i deployment in esecuzione dei clienti non sono interessati.

Per evitare errori nei nuovi deployment delle app:

  1. Esamina le versioni GKE attuali nelle note di rilascio di GKE e le versioni future nella programmazione delle release di GKE.
  2. 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 in batch/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 il k8sVersion vincolo cluster nel tuo schema.
  3. 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.
  4. Segui le istruzioni per aggiungere una nuova versione o aggiornare una versione esistente per inviare le modifiche nel portale.

Modifiche ai prezzi

Le modifiche ai prezzi vengono applicate dopo un determinato periodo di attesa e non sono immediate. Per informazioni specifiche, consulta il tuo contratto.

  1. 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 del progetto pubblico che hai creato per Cloud Marketplace, ad esempio my-organization-public.

  2. Nell'elenco dei prodotti, fai clic sull'ID prodotto.

  3. Nella pagina della Panoramica del tuo prodotto, vai a Revisione dei prezzi e fai clic su Modifica.

  4. Apporta le modifiche necessarie ai prezzi.

  5. Fai clic su Invia per inviare i prezzi per la revisione.

  6. 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 dalla pagina dei dettagli del prodotto al momento della pubblicazione. Tuttavia, la rimozione di una release non comporta la rimozione delle immagini pubblicate nel Container Registry pubblico.

  1. 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 del progetto pubblico che hai creato per Cloud Marketplace, ad esempio my-organization-public.

  2. Nell'elenco dei prodotti, fai clic sull'ID prodotto.

  3. Nella pagina Panoramica del tuo prodotto, vai alla sezione Immagini contenitore e fai clic su Modifica.

  4. Accanto a Versioni proposte, fai clic su Modifica. Potrebbero essere necessari alcuni secondi per leggere il repository e caricare i tag.

  5. Evidenzia la release che vuoi rimuovere.

  6. Fai clic su Elimina per rimuovere la versione.

  7. Fai clic su Fine.

  8. Quando hai finito di rimuovere le release dal prodotto, fai clic su Salva e convalida.

  9. Fai clic su Invia per inviare le immagini del contenitore per la revisione.

  10. 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.

Indietro
Invio dell'app a Google Cloud Marketplace