Manutenzione del prodotto

In questa pagina vengono descritte le linee guida per la manutenzione e l'aggiornamento del prodotto dopo la pubblicazione su Cloud Marketplace.

Gestire gli aggiornamenti dell'app

La procedura di aggiornamento del prodotto è simile alla creazione del pacchetto iniziale dell'app. Devi prima generare un nuovo set di immagini container per l'aggiornamento ed eseguirne il push al repository gestione temporanea di Container Registry. A seconda che tu stia aggiungendo una nuova versione o aggiornandone una esistente, segui la procedura riportata di seguito per aggiornare l'app.

Aggiunta di una nuova versione

Nel repository gestione temporanea di Container Registry, tagga le immagini delle app con un nuovo tag di versione secondaria. Dopodiché, segui i passaggi per inviare la tua app in Producer Portal.

Aggiornamento di una versione esistente

Nel repository gestione temporanea di Container Registry, tagga le immagini con il tag della versione secondaria corrente. Quindi, segui i passaggi riportati di seguito per aggiornare l'app in Producer Portal.

  1. 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 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 prodotto, vai alla sezione Immagini container e fai clic su Modifica.

  4. In base a Release proposte, fai clic su Modifica. La lettura del repository e il caricamento dei tag potrebbero richiedere alcuni secondi.

  5. Fai clic sulla release che vuoi aggiornare.

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

  7. Dopo aver aggiornato tutte le informazioni per la release, fai clic su Fine.

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

  9. Fai clic su Invia per sottoporre a revisione le immagini container.

  10. Dopo che tutte le recensioni 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 verifica l'invio.

Una volta pubblicata, la versione aggiornata diventa l'impostazione predefinita per i nuovi clienti. I clienti attuali visualizzeranno le nuove immagini inviate ai tag esistenti. I deployment nella pagina del prodotto Cloud Marketplace sono sempre bloccati nelle sintesi delle immagini e non vengono aggiornati automaticamente. Consigliamo inoltre ai clienti che eseguono il deployment dell'app di bloccare le immagini nelle digest tramite riga di comando.

Per aiutare gli utenti ad aggiornare le immagini delle app, ti consigliamo di aggiungere i passaggi di upgrade alla guida dell'utente.

Migrazione dalle API Kubernetes deprecate

Man mano che le API Kubernetes si evolvono, le API precedenti vengono deprecate e rimosse. Ciò significa che la tua app può diventare incompatibile con gli attuali cluster GKE. In genere gli oggetti esistenti sono resi persistenti, quindi i deployment in esecuzione dei clienti non sono interessati.

Per evitare errori nei deployment di nuove app:

  1. Rivedi le versioni attuali di GKE nelle note di rilascio di GKE e le versioni future nella pianificazione delle release di GKE.
  2. Aggiorna i manifest dell'app per rimuovere eventuali dipendenze dalle versioni deprecate dell'API Kubernetes che vengono rimosse in tutte le versioni attuali o future di GKE nel canale regolare o stabile. Fai riferimento alla guida alla migrazione delle API deprecate di Kubernetes.
    • Ad esempio, gli utilizzi di aggiornamento di batch/v1beta1 CronJob in batch/v1, poiché batch/v1beta1 verrà rimosso nella versione 1.25 di Kubernetes, secondo la guida.
    • Se non riesci ad aggiornare i manifest per le release precedenti dell'app, ti consigliamo di rimuovere la release o di impostare il vincolo del cluster k8sVersion nello schema.
  3. Completa il test di tutte le immagini container ricreate utilizzando lo strumento mpdev, possibilmente su un cluster con una versione di Kubernetes che non supporta l'API deprecata che stai rimuovendo.
    • Ad esempio, puoi utilizzare un cluster Kubernetes versione 1.22 per testare l'aggiornamento da CustomResourceDefinition apiextensions.k8s.io/v1beta1, che è stato rimosso in Kubernetes versione 1.22.
  4. Segui le istruzioni per aggiungere una nuova versione o aggiornare una versione esistente per inviare le modifiche al portale.

Modifiche ai prezzi

Le modifiche ai prezzi hanno effetto dopo un determinato periodo di attesa e non sono immediate. Per i dettagli, fai riferimento al tuo contratto.

  1. 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 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 prodotto, vai a Revisione dei prezzi e fai clic su Modifica.

  4. Apporta eventuali modifiche ai prezzi.

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

  6. Dopo che tutte le recensioni 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 non disponibili alcune release su Cloud Marketplace.

Rimozione della release di un'app

Quando rimuovi una release dal tuo prodotto, questa viene immediatamente rimossa dalla pagina dei dettagli del prodotto quando il prodotto viene pubblicato. Tuttavia, la rimozione di una release non rimuove le immagini pubblicate nel Container Registry pubblico.

  1. 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 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 prodotto, vai alla sezione Immagini container, quindi fai clic su Modifica.

  4. Accanto a Release 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. Al termine della rimozione delle release per il tuo prodotto, fai clic su Salva e convalida.

  9. Fai clic su Invia per sottoporre a revisione le immagini container.

  10. Dopo che tutte le recensioni 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