Amministrazione in Managed Runtime

Managed Runtime semplifica la gestione di organizzazioni, progetti, ambienti e bundle associati allo storefront PWA Kit. In questa guida vengono descritte le numerose attività di amministrazione che possono essere eseguite nello strumento Runtime Admin basato sul Web. (Tutte le attività di amministrazione illustrate in questa guida, e molte altre, possono essere eseguite anche utilizzando Managed Runtime API.)

I progetti consentono di gestire più ambienti all'interno di un'organizzazione. A ogni progetto PWA Kit deve corrispondere un progetto in Managed Runtime per la distribuzione e l'hosting del codice dello storefront nell'infrastruttura cloud pubblica di Salesforce.

Per creare un progetto in Runtime Admin:

1. Accedere a Runtime Admin.
2. Fare clic su New Project (Nuovo progetto).
3. Inserire un nome per il progetto.
4. Fare clic su Create Project (Crea progetto).

Tutte le istruzioni relative alle altre attività di amministrazione in questa guida presuppongono che si inizi dalla pagina Overview (Panoramica) di un progetto in Runtime Admin.

Per individuare un progetto esistente e aprire la relativa pagina Overview (Panoramica):

1. Accedere a Runtime Admin.
2. Selezionare un'organizzazione nel menu delle organizzazioni (in alto a sinistra), se necessario.
3. Fare clic sul nome del progetto. (Per visualizzare il progetto occorre avere uno dei ruoli di progetto descritti in precedenza.)

Per passare rapidamente da un progetto a un altro, utilizzare il menu dei progetti nella parte superiore della pagina.

Nella pagina Project Settings (Impostazioni progetto) è possibile eseguire le seguenti attività:

• Cercare l'ID progetto e verificare che corrisponda a una configurazione PWA Kit.
• Modificare l'ID progetto.
• Visualizzare e modificare il nome e l'URL del progetto.
• Eliminare il progetto.
• Gestire le notifiche di distribuzione (vedere la sezione seguente).

Per accedere alla pagina Project Settings (Impostazioni progetto):

1. Passare alla pagina Overview (Panoramica) di un progetto.
2. Fare clic su Project Settings (Impostazioni progetto) nel menu di navigazione a sinistra.

Per modificare le impostazioni, fare clic su Edit (Modifica), apportare le modifiche desiderate e fare clic su Update (Aggiorna). Per eliminare le modifiche, fare clic su Cancel (Annulla).

Per eliminare un progetto, fare clic su Delete (Elimina), inserire il nome del progetto da confermare e fare clic su Yes, Delete (Sì, elimina). Per mantenere il progetto, fare clic su No, Keep (No, mantieni).

È possibile scegliere di ricevere una notifica via email ogni volta che si verifica uno dei seguenti eventi di distribuzione:

• Avvio distribuzione
• Distribuzione riuscita
• Distribuzione non riuscita

Per aggiungere una notifica:

1. Passare alla pagina Overview (Panoramica) di un progetto.
2. Fare clic su Project Settings (Impostazioni progetto) nel menu di navigazione a sinistra.
3. Fare clic su Add Notification (Aggiungi notifica).
4. Selezionare uno o più ambienti di cui ricevere le notifiche.
5. Selezionare uno o più eventi di distribuzione.
6. Inserire gli indirizzi email di tutti i destinatari delle notifiche.
7. Fare clic su Add Notification (Aggiungi notifica).

Per modificare una notifica:

1. Passare alla pagina Overview (Panoramica) di un progetto.
2. Fare clic su Project Settings (Impostazioni progetto) nel menu di navigazione a sinistra.
3. Fare clic sul pulsante ... accanto alla notifica.
4. Fare clic su Edit (Modifica).
5. Modificare tutte le impostazioni di notifica desiderate.
6. Fare clic su Update Notification (Aggiorna notifica).

Per rimuovere una notifica:

1. Passare alla pagina Overview (Panoramica) di un progetto.
2. Fare clic su Project Settings (Impostazioni progetto) nel menu di navigazione a sinistra.
3. Fare clic sul pulsante ... accanto alla notifica.
4. Fare clic su Remove (Rimuovi).
5. Fare clic su Yes, Remove (Sì, rimuovi).

Gli ambienti vengono utilizzati per distinguere lo storefront Production da altri storefront distribuiti per altre finalità, ad esempio di sviluppo o di test. Per ulteriori informazioni sugli ambienti e su altri concetti correlati, vedere Panoramica di Managed Runtime.

Per creare un ambiente in Runtime Admin:

1. Passare alla pagina Overview (Panoramica) di un progetto.
2. Fare clic su New Environment (Nuovo ambiente).
3. Inserire un nome per l'ambiente.
4. Selezionare un'area geografica per la distribuzione nell'infrastruttura cloud pubblica di Salesforce.
5. Se si tratta di un ambiente Production, contrassegnarlo come tale. Se è stato raggiunto il limite di ambienti Production, contattare l'assistenza (Support).
6. Fare clic su Create Environment (Crea ambiente).

Per qualsiasi sito che utilizza PWA Kit e Managed Runtime, è possibile designare come distribuito un solo bundle alla volta per ogni ambiente.

1. Passare alla pagina Overview (Panoramica) di un progetto.
2. Fare clic sul nome dell'ambiente in cui si desidera effettuare la distribuzione, ad esempio Production.
3. Sotto l'intestazione Bundles (Bundle), fare clic sul pulsante Deploy (Distribuisci) accanto al bundle che si desidera distribuire.
4. Fare clic su Confirm Deploy (Conferma distribuzione).
5. Attendere il completamento della distribuzione.

Terminata la distribuzione, il bundle appare sotto l'intestazione Deployed Bundle (Bundle distribuito). (Per la prima distribuzione in un nuovo ambiente, il processo può richiedere fino a un'ora di tempo.)

Nella pagina Environment Settings (Impostazioni ambiente) è possibile eseguire in un unico luogo numerose attività di amministrazione, tra cui:

• Rinominare un ambiente o un ID ambiente.
• Cambiare l'area geografica di distribuzione.
• Autorizzare indirizzi IP specifici ad accedere all'ambiente.
• Configurare proxy per l'ambiente. Per ulteriori informazioni, vedere Invio delle richieste a un proxy.
• Contrassegnare un ambiente come Production.
• Eliminare un ambiente.

Per accedere alla pagina Environment Settings (Impostazioni ambiente):

1. Passare alla pagina Overview (Panoramica) di un progetto.
2. Fare clic sul nome dell'ambiente di cui si desidera modificare le impostazioni.
3. Fare clic su Environment Settings (Impostazioni ambiente) nel menu di navigazione a sinistra.

Per apportare modifiche, fare clic sul pulsante Edit (Modifica) accanto alle impostazioni General (Generali) o Advanced (Avanzate). Una volta apportate le modifiche desiderate, fare clic su Update (Aggiorna) per salvarle o su Cancel (Annulla) per eliminarle.

Le variabili di ambiente consentono di aggiungere variabili a un processo di applicazione in esecuzione in un ambiente senza dover modificare il codice. Le variabili di ambiente vengono archiviate in maniera sicura e il loro utilizzo è ideale nei seguenti casi:

• Chiavi API per integrazioni di terze parti
• Flag di funzionalità per logica di applicazione
• Diverse configurazioni per diversi ambienti

È possibile gestire le variabili di ambiente mediante Managed Runtime API e accedervi in Node.js mediante process.env.

Per impostare, aggiornare e annullare l'impostazione delle variabili di ambiente, utilizzare projects_target_env_var_partial_update:

Scegliere i nomi delle variabili di ambiente più appropriati per la propria app. I valori delle variabili di ambiente possono essere di tipo booleano, intero o stringa. Per impostare valori complessi, codificare JSON in una stringa.

Per annullare l'impostazione di una variabile di ambiente esistente, impostarne il valore su null.

La modifica delle variabili di ambiente comporta una ridistribuzione del bundle corrente per l'ambiente.

Per impostare tutte le variabili di ambiente su un ambiente, utilizzare projects_target_env_var_list:

L'utilizzo delle variabili di ambiente è soggetto ai seguenti vincoli:

• Ogni ambiente ha un limite di 100 variabili.
• La dimensione massima dei valori delle variabili di ambiente impostate per un ambiente è 32 KB.
• I nomi delle variabili di ambiente devono contenere al massimo 512 caratteri e non possono iniziare con prefissi riservati: AWS, MRT, X_MRT, MOBIFY, X_MOBIFY, SSR_PROXY.
• Non è possibile utilizzare i nomi delle variabili di ambiente riservati: BUNDLE_ID, DEPLOY_ID, DEPLOY_TARGET, EXTERNAL_DOMAIN_NAME, HANDLER, LAMBDA_RUNTIME_DIR, LAMBDA_TASK_ROOT, NODE_ENV, REDIRECT_BUCKET, REDIRECT_KEY, REDIRECT_UPDATE, REMOTE, X_AMZN_TRACE_ID.

Un reindirizzamento consente di inoltrare una richiesta dall'URL richiesto a un altro URL. I reindirizzamenti possono essere utili per evitare interruzioni dell'esperienza utente causate dalle modifiche allo storefront. Si consideri, ad esempio, la pagina di una campagna stagionale per la primavera. Quando questa campagna termina e viene sostituita con una campagna estiva, è possibile creare un reindirizzamento dall'URL della campagna primaverile a quello della campagna estiva.

I reindirizzamenti sono una funzionalità potente che può avere conseguenze significative sulla sicurezza dello storefront, incluso il reindirizzamento a URL o asset dannosi. Prestare attenzione quando si assegnano agli utenti ruoli che concedono l'accesso ai reindirizzamenti.

Per creare un reindirizzamento:

1. Passare alla pagina Overview (Panoramica) di un progetto.
2. Fare clic sul nome dell'ambiente in cui si desidera creare il reindirizzamento.
3. Fare clic su URL Redirects (Reindirizzamenti URL) nel menu di navigazione a sinistra.
4. Fare clic su Create Redirect (Crea reindirizzamento).
5. Nel campo Redirect From (Reindirizza da), inserire un percorso URL relativo. Ad esempio, per reindirizzare i visitatori dall'URL www.example.com/winter, inserire /winter.
6. Nel campo Redirect To (Reindirizza a), inserire un percorso URL relativo.
7. Se necessario, abilitare l'inoltro dei parametri di query e del percorso con caratteri jolly. (A breve verranno fornite ulteriori informazioni sulle impostazioni di inoltro.)
8. Nel menu a discesa Redirect Type (Tipo di reindirizzamento), selezionare un tipo di reindirizzamento in base al codice di stato HTTP. (A breve verranno fornite ulteriori informazioni sui codici di stato.)
9. Fare clic su Create Redirect (Crea reindirizzamento).

Di seguito vengono illustrate in modo più dettagliato le opzioni per la creazione di un reindirizzamento.

Il valore inserito nel campo Redirect From deve essere sempre un percorso relativo. Il valore nel campo Redirect To può essere un percorso relativo o un URL completo. Ad esempio, si supponga di voler reindirizzare i visitatori da www.example.com/spring a www.example.com/summer. Il valore nel campo Redirect From deve essere /spring. Il valore nel campo Redirect To può essere /summer o www.example.com/summer.

È possibile aggiungere un asterisco (*) alla fine dell'URL Redirect From per indicare un carattere jolly. Un carattere jolly corrisponde a 0 o più caratteri qualsiasi nell'URL. Ad esempio, un reindirizzamento da /a/* corrisponde a /a/, /a/b e /a/b/c.

Il carattere asterisco può essere utilizzato solo alla fine dell'URL Redirect From.

I reindirizzamenti standard vengono elaborati per primi da Managed Runtime, seguiti da quelli con caratteri jolly.

La maggior parte dei reindirizzamenti utilizza il codice di stato Permanente (301), ma è possibile selezionare anche Temporaneo (302). In caso di dubbio sul codice di stato HTTP da utilizzare, consultare questa spiegazione dei codici di stato su MOZ.com.

Alcune richieste contengono parametri di stringa di query che è consigliabile includere nella richiesta reindirizzata. Ad esempio, al percorso relativo /spring-landing-page può essere aggiunta una stringa di query per il monitoraggio dei dati, ad esempio /spring-landing-page?gclid=123.

Per abilitare l'inoltro dei parametri di query, passare alla sezione Forward (Inoltra) del form e selezionare Query Parameters (Parametri di query). In caso contrario, i parametri di stringa di query dell'URL sorgente non vengono inclusi nell'URL di reindirizzamento.

Che cosa accade quando gli URL Redirect From e Redirect To presentano entrambi stringhe di query e l'inoltro è abilitato? In questo caso, l'URL di reindirizzamento include una combinazione delle due stringhe di query. I parametri di query dell'URL Redirect To vengono aggiunti alla stringa di query nella richiesta. Ad esempio, si supponga che l'applicazione riceva una richiesta del percorso relativo /spring?year=2019. Se si è scelto di reindirizzare /spring a /summer?year=2020, l'URL di reindirizzamento è /summer?year=2019&year=2020 quando l'inoltro è abilitato.

È possibile includere automaticamente nell'URL Redirect To qualsiasi percorso che segue la porzione dei caratteri jolly dell'URL Redirect From. Ad esempio, se /a/* corrisponde a /a/b/c nell'URL Redirect From e l'URL Redirect To è /z/, l'URL di reindirizzamento è /z/b/c.

Per abilitare l'inoltro del percorso con caratteri jolly, passare alla sezione Forward (Inoltra) del form e selezionare Wildcard Path (Percorso con caratteri jolly).

È possibile copiare tutti i reindirizzamenti da un ambiente a un altro utilizzando l'apposita funzionalità di clonazione.

Per clonare i reindirizzamenti:

1. Passare alla pagina Overview (Panoramica) di un progetto.
2. Fare clic sul nome dell'ambiente contenente i reindirizzamenti che si desidera clonare.
3. Fare clic su URL Redirects (Reindirizzamenti URL) nel menu di navigazione a sinistra.
4. Fare clic su Clone Redirects (Clona reindirizzamenti). Viene visualizzato il form Clone Redirects (Clona reindirizzamenti). L'ambiente corrente è riportato in From Environment (Ambiente di origine) (l'origine).
5. In To Environment (Ambiente di destinazione), selezionare l'ambiente in cui si desidera clonare i reindirizzamenti (la destinazione).
6. Fare clic su Clone n Redirects (Clona n reindirizzamenti), (dove n. è il numero dei reindirizzamenti da clonare).

Per modificare le impostazioni di un reindirizzamento esistente:

1. Passare alla pagina Overview (Panoramica) di un progetto.
2. Fare clic sul nome dell'ambiente contenente il reindirizzamento che si desidera modificare.
3. Fare clic su URL Redirects (Reindirizzamenti URL) nel menu di navigazione a sinistra.
4. Fare clic sul pulsante con i puntini di sospensione (...) accanto al reindirizzamento.
5. Fare clic su Edit (Modifica).
6. Aggiornare le impostazioni.
7. Fare clic su Update Redirect (Aggiorna reindirizzamento).

Per eliminare un reindirizzamento:

1. Passare alla pagina Overview (Panoramica) di un progetto.
2. Fare clic sul nome dell'ambiente contenente il reindirizzamento che si desidera eliminare.
3. Fare clic su URL Redirects (Reindirizzamenti URL) nel menu di navigazione a sinistra.
4. Fare clic sul pulsante con i puntini di sospensione (...) accanto al reindirizzamento.
5. Fare clic su Delete (Elimina).
6. Fare clic su Yes, Delete Redirect (Sì, elimina reindirizzamento).

Se un reindirizzamento non funziona come previsto, provare a seguire questa procedura di risoluzione dei problemi:

• Cancellare la cache del browser perché i reindirizzamenti sono memorizzati in cache.
• Verificare che le impostazioni visualizzate siano relative all'ambiente corretto.
• Modificare il reindirizzamento e verificare che nei campi Redirect From e Redirect To siano inseriti i valori corretti.

I reindirizzamenti presentano i seguenti limiti tecnici:

• Ogni ambiente può avere un massimo di 10.000 reindirizzamenti.
• Ogni ambiente ha un proprio set di reindirizzamenti. È responsabilità dell'utente mantenerli sincronizzati mediante la clonazione.
• La funzionalità dei reindirizzamenti supporta i reindirizzamenti semplici da un percorso a un altro. Per i reindirizzamenti complessi con istruzioni condizionali consultare l'assistenza sui reindirizzamenti di Express.js in ssr.js.
• I reindirizzamenti creati con lo strumento Runtime Admin o con Managed Runtime API non vengono eseguiti negli ambienti di sviluppo locali.
• I reindirizzamenti possono venire attivati solo da una richiesta HTTP e non dalle transizioni di pagina nell'applicazione PWA Kit.

Si riportano di seguito le attività di gestione degli utenti.

Per aggiungere un utente a un progetto:

1. Passare alla pagina Overview (Panoramica) di un progetto.
2. Fare clic su Users & Permissions (Utenti e autorizzazioni) nel menu di navigazione a sinistra.
3. Fare clic su New User (Nuovo utente).
4. Inserire l'indirizzo email dell'utente. (Verificare che l'utente faccia parte dell'organizzazione e abbia uno dei seguenti ruoli in Account Manager: Managed Runtime User (Utente Managed Runtime) o Managed Runtime Admin (Amministratore Managed Runtime).)
5. Selezionare un ruolo.
6. Fare clic su Add User (Aggiungi utente).

Per modificare il ruolo di un utente:

1. Passare alla pagina Overview (Panoramica) di un progetto.
2. Fare clic su Users & Permissions (Utenti e autorizzazioni) nel menu di navigazione a sinistra.
3. Fare clic sul pulsante ... accanto al nome dell'utente.
4. Fare clic su Edit (Modifica).
5. Selezionare un ruolo.
6. Fare clic sul menu popup visualizzato.
7. Selezionare un nuovo ruolo.
8. Fare clic su Save (Salva).

Per un elenco delle funzionalità utente associate a ogni ruolo, vedere Panoramica di Managed Runtime.

Per rimuovere un utente da un progetto:

1. Passare alla pagina Overview (Panoramica) di un progetto.
2. Fare clic su Users & Permissions (Utenti e autorizzazioni) nel menu di navigazione a sinistra.
3. Fare clic sul pulsante ... accanto al nome dell'utente.
4. Fare clic su Remove (Rimuovi).
5. Fare clic su Yes, Remove User (Sì, rimuovi utente).