Esportazione e importazione di temi personalizzati e configurazione del sito

Puoi utilizzare i comandi del portale nella CLI del toolkit per replicare le modifiche da un'istanza del portale sviluppatore ad un'altra. È possibile utilizzare questi comandi per copiare i temi o una modifica di configurazione, da un ambiente di staging a un ambiente di produzione.

Prima di iniziare

Per completare questo scenario, devi avere un Developer Portal di preparazione e un Developer Portal di produzione abilitati. Per completare questo scenario, è necessario disporre dell'accesso di amministratore e dell'autorizzazione settings:manage. L'esercitazione Creazione del portale spiega come abilitare il portale, se non è già stato fatto.

Informazioni su questo scenario

In questo scenario, nel tuo Developer Portaldi staging, crei un tema e apporta delle modifiche alla configurazione. Utilizza quindi la CLI del toolkit per replicare le modifiche nel tuo Developer Portaldi produzione.

Questo scenario consente di effettuare le seguenti operazioni:
  1. Crea un tema personalizzato nel Developer Portaldi preparazione.
  2. Aggiungi un campo a un tipo di contenuto dell'applicazione per modificare site-config nel Developer Portaldi preparazione.
  3. Utilizza cli per esportare i temi personalizzati e site-config nel Developer Portaldi staging.
  4. Utilizzare cli per importare i temi personalizzati e site-config nel Developer Portal di produzione.

Crea un tema personalizzato nel Developer Portal di staging

  1. Accedi al tuo Developer Portal di preparazione come amministratore.
  2. Se il dashboard dell'amministratore non viene visualizzato, fare clic su Gestisci per visualizzarlo.
  3. Fare clic su Aspetto > Genera tema secondario. Viene visualizzata la finestra Generate sub-theme .
  4. Immettere un Nome tema secondarioe selezionare CSS per il Tipo di tema secondario. (Se si preferisce, è possibile selezionare SCSS, ma questa estensione a CSS è per sviluppatori di temi avanzati e non è coperta da questo scenario.)
    Genera finestra del tema secondario.
  5. Selezionare il modello Predefinito su cui basare sub-theme . È possibile creare un sub-theme basato su un modello di colore. Tuttavia, per questo scenario si utilizza il modello connect_theme predefinito.
  6. Fare clic su Genera.
  7. Scaricare il file sub-theme generato in un percorso a scelta ed estrarre tutti i file dal file .zip .

Sul computer, passare ai file estratti. Trovare il overrides.css file qui banka_theme/banka_theme/css/overrides.css. È ora possibile personalizzare il file overrides.css .

  1. Aprire il file overrides.css nell'editor scelto.
  2. Personalizzare sub-theme immettendo i seguenti elementi nel file overrides.css :
    /* Body of the home page */
body.path-frontpage.contexthome {
  color: #152935;
  background-color: #d1f0f7;
}

/* Header of the home page */
.navbar {
  background-color: #a0a0a0;
}

/* Footer of the home page */
footer.footer {
background-color: #dee0e2;
}

footer.footer ul.nav > li > a {
color: #454A4C;
}
    Copiare il blocco di codice specificato nel proprio file css
  3. Salvare il file overrides.css.

È ora possibile installare e abilitare il tema personalizzato.

  1. Una volta terminato l'aggiornamento del file overrides.css , comprimere nuovamente tutti i file del tema nel file .zip sub-theme scaricato originariamente.
  2. In Developer Portal, fai clic su Aspetto > Installa nuovo tema. Viene visualizzata la finestra Install new theme .
  3. In Caricare un modulo o un archivio di temi da installare fare clic su Sfogliae passare al file di temi compresso appena aggiornato.
  4. Fare clic su Installa per installare il tema sul sito.
  5. Fare clic su Abilita temi appena aggiuntie trovare il proprio nuovo tema nell'elenco di Disabled themes. Fare clic su Abilita e imposta come predefinito per impostare il nuovo tema personalizzato sub-theme come predefinito per il sito.
  6. Tornare alla home page di Developer Portal facendo clic su Torna al sito. È ora possibile visualizzare il tema personalizzato.
    La home page con il tema aggiornato

Aggiungere un campo ad un tipo di contenuto dell'applicazione per modificare site-config nel Developer Portal di staging

  1. Accedi al tuo Developer Portal di preparazione come amministratore.
  2. Se il dashboard dell'amministratore non viene visualizzato, fare clic su Gestisci per visualizzarlo.
  3. Fare clic su Struttura > Tipi di contenuto > Applicazione > Gestisci campi.
  4. Fare clic su + Aggiungi campo.
  5. In Add a new field, selezionare Testo (semplice, lungo). Immettere Company name come titolo dell'etichetta.

    Una schermata della pagina Aggiungi campo

  6. Fare clic su Salva e continua.
  7. Lasciare Allowed number of values impostato su 1 e fare clic su Salva impostazioni campo.
  8. Fare clic su Salva impostazioni campo. Ora puoi vedere il nuovo campo.

    Nuovo campo ora visualizzato nell'elenco

Utilizza la CLI toolkit per esportare i temi personalizzati e site-config nel Developer Portal di staging

  1. Accedere al server di gestione.
    apic login --server management_server --realm realm --username org_username --password org_password
    Ad esempio:
    apic login -s manager.stagingexample.com --realm provider/default-idp-2 --username ibm --password Qwerty123£

    Per ulteriori informazioni sulle opzioni delle variabili, consultare Accesso a un server di gestione.

  2. Esportare i temi personalizzati.
    Il comando custom-theme:create-export crea un'attività di esportazione rispetto al portale di catalog e orgspecificati. Il comando esegue quindi il polling dello stato dell'attività fino a quando non dispone di FINISHED e le risorse utente non vengono ritrasmesse.
    Nota: il comando continua a eseguire il polling finché non viene raggiunto il tempo massimo di polling di 15 minuti. A quale punto è possibile utilizzare i comandi custom-theme:get-export-status e custom-theme:get-export per ottenere lo stato e potenzialmente una risorsa utente.
    apic --mode portaladmin custom-theme:create-export --catalog name/id --org name/id --server management_server
    • Il tema .tgz viene salvato nella directory in cui è stato eseguito il comando.
    • Il .tgz salvato ha il formato custom_theme_createExport-20200217134637.tgz.
    • È possibile salvare le esportazioni nel sistema di gestione del controllo modifiche.
    Ad esempio:
    apic --mode portaladmin custom-theme:create-export --catalog dev --org ibm --server manager.stagingexample.com
  3. Esportare la configurazione del sito.

    Il comando site-config:create-export crea un'attività di esportazione rispetto al portale dei catalog e orgspecificati, il comando esegue il polling dello stato dell'attività fino a quando non dispone di FINISHED e le risorse utente non vengono ritrasmesse.

    apic --mode portaladmin site-config:create-export --catalog name/id --org name/id --server management_server
    • La configurazione del sito .tgz viene salvata nella directory in cui è stato eseguito il comando.
    • Il .tgz salvato ha il formato site_config_createExport-20200217134637.tgz.
    • È possibile salvare le esportazioni nel sistema di gestione del controllo modifiche.
    Ad esempio:
    apic --mode portaladmin site-config:create-export --catalog dev --org ibm --server manager.stagingexample.com
Nota: Per la risoluzione dei problemi relativi all'esportazione o all'importazione di site-config , vedere Perché si verificano problemi di migrazione con ambienti non identici?

Utilizza la CLI toolkit per importare i temi personalizzati e site-config nel Developer Portal di produzione

  1. Accedere al server di gestione.
    apic login --server management_server --realm realm --username org_username --password org_password
    Ad esempio:
    apic login -s manager.productionexample.com --realm provider/default-idp-2 --username ibm --password Qwerty123£

    Per ulteriori informazioni sulle opzioni delle variabili, consultare Accesso a un server di gestione.

  2. Importare i temi personalizzati.
    Il comando custom-theme:create-import utilizza il file .tgz fornito per importare i temi personalizzati nel portale di catalog e orgspecificati. Il comando esegue quindi il polling dello stato dell'attività fino a quando l'attività non è FINISHED riuscita o non è riuscita a causa di un errore.
    Nota: il comando continua a eseguire il polling finché non viene raggiunto il tempo massimo di polling di 15 minuti. A questo punto è possibile utilizzare il comando custom-theme:get-import-status per ottenere lo stato dell'importazione.
    apic --mode portaladmin custom-theme:create-import --catalog name/id --org name/id --server management_server /PATH/TO/THEME/TGZ
    Ad esempio:
    apic --mode portaladmin custom-theme:create-import --catalog prod --org ibm --server manager.productionexample.com C:/users/example/desktop/custom_theme_createExport-20200217134637.tgz
  3. Importare la configurazione del sito.

    Il comando site-config:create-import utilizza il file di .tgz fornito per importare la configurazione del sito nel portale dei catalog e orgspecificati. Il comando esegue quindi il polling dello stato dell'attività fino a quando l'attività non è FINISHED riuscita o non è riuscita a causa di un errore.

    apic --mode portaladmin site-config:create-import --catalog name/id --org name/id --server management_server /PATH/TO/CONFIG/TGZ
    Ad esempio:
    apic --mode portaladmin site-config:create-import --catalog prod --org ibm --server manager.productionexample.com C:/users/example/desktop/site_config_createExport-20200217134637.tgz

Cosa hai fatto in questo scenario

In questo scenario, hai creato un tema e modificato la configurazione nel tuo Developer Portaldi staging. Hai quindi utilizzato la CLI del toolkit per replicare le modifiche sul tuo Developer Portaldi produzione.

Puoi ora vedere le modifiche che hai apportato al Developer Portaldi produzione.