Integrazione del software nel tuo catalogo privato

Il processo per eseguire l'onboarding del software include l'importazione di una versione nel catalogo privato, la configurazione dei dettagli di distribuzione, l'impostazione di eventuali requisiti di licenza e la verifica che la versione possa essere installata correttamente sull'infrastruttura di destinazione richiesta.

Prima di iniziare

  1. Caricate il codice sorgente in una release nel vostro repository GitHub, GitLab, o Azure. Per ulteriori informazioni, vedere Configurazione del repository del codice sorgente.

  2. Verifica che stai utilizzando un account Pagamento a consumo o Sottoscrizione. Per ulteriori informazioni, vedi Visualizzazione del tuo tipo di account.

  3. Assicurati di aver assegnato il ruolo di editor al servizio di gestione del catalogo. Vedi Assegnazione dell'accesso ai servizi di gestione dell'account.

  4. Impostare l'ambiente di test precedentemente creato per l'utente:

Importazione di una versione nel tuo catalogo privato

Completa la seguente procedura per importare una versione del tuo software nel catalogo privato. Il tuo catalogo privato è stato creato per te come parte di Introduzione alla vendita di software.

  1. Nella console IBM Cloud, fare clic sull'icona Menu di navigazione icona Menu di navigazione > Partner Center > I miei prodotti.

  2. Selezionare il prodotto che si sta onboarding.

  3. Dalla scheda Software, fare clic su Importa una versione.

  4. Selezionare il metodo di distribuzione.

  5. Selezionare se si sta aggiungendo il proprio prodotto da un repository privato o pubblico. Per gli operatori, selezionare il repository di origine e scegliere il repository privato o pubblico.

  6. Inserisci l' URL e di origine.

    È possibile esaminare il seguente elenco di formati supportati per tipo di software:

    • Grafico Helm: https://raw.githubusercontent.com/IBM/charts/master/repo/ibm-helm
    • Node-RED: https://github.com/IBM-Cloud/operator-bundle-sample/archive/refs/tags/v0.0.3.tar.gz
    • Bundle di operatori da un registro Red Hat OpenShift on IBM Cloud: per un esempio, selezionare Akka Cluster Operator dall'elenco di operatori disponibili nel repository certificato.
    • Immagine OVA: https://github.com/gcatalog/OVA-sample/blob/main/ova-sample.yaml
    • Modello Terraform: https://github.com/IBM-Cloud/terraform-sample/archive/refs/tags/v1.1.0.tar.gz
    • Immagine del server virtuale con Terraform: https://github.com/IBM-Cloud/isv-vsi-product-deploy-sample/releases/download/v1.0/isv-vsi-product-deploy-sample.tar.gz
    • Immagine server virtuale per VPC: seleziona un'immagine dall'elenco di immagini disponibili che sono state importate nel tuo VPC o importa una nuova immagine nel tuo account.

    Un'immagine server virtuale per VPC può essere aggiunta solo ad un prodotto alla volta all'interno di un catalogo privato. Se l'immagine server virtuale che si desidera importare è già importata in un altro prodotto, è necessario rimuovere l'immagine da tale prodotto o eliminare il prodotto prima di aggiungere l'immagine server virtuale a un nuovo prodotto.

    Se stai aggiungendo il prodotto da un repository privato, puoi scegliere di fornire un token di accesso personale o puoi utilizzare un segreto. Invece di fornire agli utenti un token di accesso personale, è possibile fornire loro l'accesso a un segreto, aggiungere il token a un segreto e gestire centralmente tutti i token e accedere alle autorizzazioni del segreto.

    Se il tuo software si trova in GitLab, devi utilizzare un token di accesso personale poiché GitLab non supporta il download delle versioni utilizzando i token di accesso al progetto. È possibile creare un token di accesso personale con l'autorizzazione " read_api seguendo le istruzioni qui.

    • Se stai utilizzando un token di accesso personale, seleziona No per indicare che non stai utilizzando un segreto e fornisci il tuo token di accesso personale.
    • Se si utilizza un segreto, selezionare e fare clic su Seleziona da Secrets Manager. Seleziona la tua istanza del servizio, il gruppo di segreti e il segreto. Se non vedi il tuo segreto, assicurati di utilizzare il gruppo di segreti e l'istanza del servizio corretti.

    Il messaggio No service instance available potrebbe essere visualizzato se non hai creato un segreto o se non disponi dell'accesso corretto per utilizzare i segreti, anche se hai delle istanze del servizio che vengono create.

  7. Se applicabile, impostare la propria destinazione di distribuzione e aggiungere la propria versione software.

  8. Fare clic su Aggiungi versione.

Configurazione dei dettagli della versione

  1. Dall'elenco di versioni, fare clic sulla riga che contiene il proprio software.
  2. Controlla i dettagli della versione e fai clic su Avanti.
  3. A seconda del tipo di software, potrebbero essere necessari ulteriori passi, tra cui l'impostazione dei valori di distribuzione.
  4. Fai clic su Next.

Imposta valori di distribuzione

Se applicabile al tipo di software, è possibile impostare i valori di distribuzione che gli utenti devono specificare quando installano il software. È possibile aggiungere nuovi valori di distribuzione o importare i valori di distribuzione da una versione esistente.

Aggiungi nuovi valori di distribuzione

  1. Fare clic su Configura versione > Avanti.
  2. Fare clic su " Aggiungi valori di distribuzione ".
  3. Nella tabella, selezionare Parametro > Aggiungi per selezionare e aggiungere tutte le opzioni.
  4. Se necessario, è possibile personalizzare i parametri selezionandoli dalla tabella e facendo clic su Modifica.

Importa valori esistenti

Completare questa procedura se in precedenza sono stati impostati i valori di distribuzione per una versione esistente e si desidera importare i valori nella versione corrente.

I valori importati non sostituiscono i valori di distribuzione già aggiunti alla versione corrente.

  1. Fare clic su Configura versione > Avanti.
  2. Fare clic su " Aggiungi valori di distribuzione ".
  3. Fai clic su " Importa valori da una versione precedente "
  4. Seleziona la versione che contiene i valori che desideri importare.
  5. Fai clic su Import.
  6. Se necessario, è possibile personalizzare i parametri selezionandoli dalla tabella e facendo clic su Modifica.

Modifica descrizioni valori di emissione

Puoi migliorare le descrizioni per i valori di output del tuo modello Terraform per aiutare gli utenti a comprendere meglio lo scopo dei parametri. La descrizione di qualsiasi valore di output incluso nel modello può essere aggiornata.

Per aggiungere valori di output, è necessario includerli in una nuova versione importata del modello Terraform.

Completare la seguente procedura per modificare le descrizioni dei valori di output del prodotto:

  1. Fare clic su Configura versione > Avanti.
  2. Dalla sezione Descrizioni valori di emissione, fornire una nuova descrizione per il parametro che si desidera aggiornare.
  3. Fai clic su Next.

Definisci accesso IAM

Se applicabile al tuo tipo di software, puoi aggiungere i ruoli di accesso al servizio e di accesso alla piattaforma richiesti per installare il tuo prodotto dal catalogo IBM Cloud. Puoi definire un nuovo accesso IAM o importare l'accesso IAM che hai impostato in una versione precedente.

Definizione di un nuovo accesso IAM

Utilizzare la seguente procedura per definire l'accesso del prodotto:

  1. Fare clic su Configura versione > Avanti > Avanti.
  2. Fai clic su Aggiungi.
  3. Selezionare il servizio e il servizio richiesto e l'accesso alla piattaforma.
    • Il ruolo di accesso al servizio consente di utilizzare il servizio ed eseguire chiamate all'API del servizio.
    • Il ruolo di accesso alla piattaforma consente di eseguire operazioni sulle risorse della piattaforma, quali la creazione di un’istanza, il collegamento delle istanze alle app e l’assegnazione dei diritti di accesso agli utenti.
  4. Fare clic su Salva.

Importazione dell'accesso IAM esistente

Completare la seguente procedura se è stato precedentemente definito l'accesso IAM per una versione esistente e si desidera importare i valori nella propria versione corrente.

L'accesso IAM importato non sostituisce alcun accesso IAM già aggiunto alla versione corrente.

  1. Fare clic su Configura versione > Avanti > Avanti.
  2. Fai clic su Aggiungi.
  3. Fai clic su Importa accesso IAM da una versione precedente.
  4. Seleziona la versione che contiene l'accesso IAM che vuoi importare.
  5. Fai clic su Aggiungi.

Aggiunta di accordi di licenza

Se agli utenti viene richiesto di accettare accordi di licenza oltre all'Accordo sui servizi di IBM Cloud quando installano il software, fornire l' URL e a ciascun accordo o importare le licenze da una versione esistente.

Aggiungi nuovi accordi di licenza

  1. Fare clic su Aggiungi accordi di licenza > Aggiungi licenza.
  2. Inserisci il nome e l' URL, quindi fai clic su Aggiungi licenza.
  3. Una volta immessi tutti gli accordi di licenza aggiuntivi, fare clic su Avanti.

Importa accordi di licenza

Completare questa procedura se sono stati precedentemente aggiunti accordi di licenza per una versione esistente e si desidera importare le licenze nella propria versione corrente.

Le licenze importate non sostituiscono gli accordi di licenza già aggiunti alla versione corrente.

  1. Fare clic su Aggiungi accordi di licenza > Aggiungi licenza.
  2. Fare clic su " Importa licenze da una versione precedente ".
  3. Seleziona la versione che contiene le licenze che desideri importare.
  4. Fai clic su Import.

Revisione del proprio file readme

Quando gli utenti installano il software, possono visualizzare le informazioni sul prodotto facendo clic sul link Readme. Le informazioni nel collegamento Readme vengono generate dal file readme caricato nel repository di origine.

  1. Dalla scheda Modifica readme, fare clic sull'icona Modifica icona Modifica.
  2. Anteprima della modalità di visualizzazione delle informazioni nel file readme per gli utenti durante l'installazione del software.
  3. Per effettuare aggiornamenti, fare clic sull'icona Modifica icona Modifica accanto al titolo della sezione Readme.
  4. Fare clic su Salva.
  5. Fai clic su Next.

Se stai importando un'immagine del server virtuale per VPC, il file readme non viene generato automaticamente. Copiare e incollare il contenuto del modello di file readme e apportare gli aggiornamenti necessari.

Convalida del prodotto

La procedura di convalida del prodotto può variare in base al tipo di software che si sta effettuando l'onboarding.

  1. Dalla scheda Convalida del prodotto, configurare la destinazione di convalida e fare clic su Avanti. Questo passo si applica solo a grafici e operatori Helm.
  2. Configurare lo spazio di lavoro e fare clic su Avanti. Questo passo si applica solo a grafici Helm, operatori, modelli Terraform e immagini server virtuale con Terraform.
  3. Fare clic su " Convalida ".

Per monitorare l'avanzamento del processo di convalida, fare clic su Visualizza log.

Convalida del software utilizzando l'API

Puoi convalidare il tuo software richiamando l'API di gestione del catalogo.

String authRefreshToken = "{authRefreshToken}";
String versionLocator = "{versionLocator}";
ValidationInstallOptions installOptions = new ValidationInstallOptions.Builder().xAuthRefreshToken(authRefreshToken).versionLocId(versionLocator).build();
Response<Void> response = service.validationInstall(installOptions).execute();
System.out.println(response.getResult());
versionLocator = "{versionLocator}";
authRefreshToken = "{authRefreshToken}";
response = await service.validationInstall({ 'versionLocatorId': versionLocator, 'xAuthRefreshToken': authRefreshToken });
console.log(response);
authRefreshToken="{authRefreshToken}"
versionLocator = "{versionLocator}"
response = self.service.validation_install(version_locator_id=versionLocator, x_auth_refresh_token=authRefreshToken)
print(response)
versionLocator := "{versionLocator}"
authRefreshToken := "{authRefreshToken}"
installOptions := service.NewValidationInstallOptions(versionLocator, authRefreshToken)
response, _ := service.ValidationInstall(installOptions)
fmt.Println(response)

Gestione dei controlli di sicurezza e di conformità

I controlli sono misure di protezione che vengono utilizzate per soddisfare i requisiti di sicurezza e di conformità. Nel catalogo compaiono solo i controlli Workload Protection supportati da. Per ulteriori informazioni, consultare Formattazione dei controlli nel file readme.

Aggiunta di controlli

Per aggiungere i controlli, procedere come segue:

  1. Nella pagina Gestisci conformità, seleziona Aggiungi controlli.

  2. Seleziona Workload Protection un'istanza, quindi una policy.

    Se non hai ancora fornito Workload Protection un'istanza, devi configurarne una dal catalogo IBM Cloud e abilitare Cloud Security Posture Management(CSPM) per il tuo IBM Cloud account. Quindi, completa i passaggi per l'integrazione con un'istanza Workload Protection esistente o con una nuova istanza.

  3. Selezionare se si desidera aggiungere l'intera politica o solo un sottoinsieme di controlli.

  4. Se scegli di aggiungere un'intera politica, passa al passaggio successivo. Se si sceglie di aggiungere un sottoinsieme di controlli, selezionare i controlli che si desidera aggiungere.

  5. Fai clic su Aggiungi.

Aggiunta dei risultati dell'inventario da Workload Protection

È possibile aggiungere i risultati dell'inventario da Workload Protection in modo che gli utenti possano vedere la conformità dichiarata quando valutano il prodotto nel catalogo.

In Workload Protection, il tuo inventario viene aggiornato una volta al giorno. È necessario distribuire le risorse e attendere l'aggiornamento dell'inventario prima di aggiungere l'inventario al proprio elenco di cataloghi. Per ulteriori informazioni, vai su Inventario.

Per aggiungere i risultati dell'inventario, procedere come segue:

  1. Nella pagina "Gestisci conformità", fare clic su "Aggiungi risultati".
  2. Seleziona Workload Protection l'istanza che hai precedentemente fornito.
  3. Fai clic su Applica per applicare gli ultimi risultati dell'inventario.