Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
Apigee utilizza Pantheon, un servizio di gestione dei siti web, per l'hosting di versioni basate su cloud del portale di Servizi per gli sviluppatori. Pantheon è progettato per funzionare con Drupal per consentirti di sviluppare, testare e pubblicare il tuo portale in un ambiente sicuro. Il servizio di gestione dei siti web di Pantheon è disponibile per i clienti con esigenze relative a operazioni di hosting e sviluppo in tutto il mondo.
Le seguenti sezioni descrivono come utilizzare Pantheon per sviluppare e gestire il tuo portale.
Accesso alla dashboard di Pantheon
Quando Apigee ti invia l'URL del tuo portale, ricevi anche l'URL della dashboard di Pantheon: https://dashboard.getpantheon.com/.
Quando accedi per la prima volta alla dashboard di Pantheon, viene visualizzata la pagina Siti, mostrata di seguito:
Dalla dashboard puoi accedere al sito, configurare il tuo account ed eseguire altre operazioni.
Seleziona l'immagine del tuo sito (ad esempio apigeedocs) per aprire la dashboard del sito:
Gestione degli ambienti
Nella dashboard di Pantheon sono elencati tre ambienti nella parte superiore della pagina: Sviluppo, Test e Dal vivo. ciascuno dei quali è descritto nella tabella seguente.
|
Ambiente |
Descrizione |
|---|---|
|
Sviluppatori |
L'ambiente Dev è connesso al tuo repository Git. Tutte le modifiche di cui esegui il push a Git vengono visualizzate immediatamente nell'ambiente Dev. L'URL di questo sito è nel formato seguente, dove org_name è il nome della tua organizzazione: http://dev-{org_name}.devportal.apigee.io/ |
|
Prova |
L'ambiente di test consente di testare il codice più recente con una copia dei dati dell'ambiente Live. È in questo ambiente che puoi testare le modifiche al codice prima di eseguirne il push nell'ambiente Live. L'URL di questo sito è nel formato seguente, dove org_name è il nome della tua organizzazione: http://test-{org_name}.devportal.apigee.io/ |
|
In diretta |
L'ambiente Live è l'ambiente di produzione che rendi accessibile ai clienti. L'URL di questo sito è nel formato seguente, dove org_name è il nome della tua organizzazione: http://live-{org_name}.devportal.apigee.io/ |
Sviluppo dei contenuti del portale
Le seguenti sezioni descrivono come sviluppare i contenuti del portale.
- Panoramica del repository Git
- Accesso al codice
- Deployment del codice negli ambienti dei portali
- Aggiungere moduli e temi personalizzati
- Override dei moduli del profilo e dei temi Drupal
Inoltre, consulta le sezioni seguenti per maggiori dettagli sulla personalizzazione del portale.
|
Se vuoi... |
Puoi |
Ulteriori informazioni |
|---|---|---|
|
Modificare l'aspetto e il design del sito |
Di base: utilizza la voce di menu Aspetto sul sito del portale per apportare modifiche, ad esempio modificare il logo e i colori del sito. |
Vedi Personalizzare l'aspetto: |
|
Avanzata: per apportare modifiche all'aspetto e al design completi del sito, estendi il tema adattabile Apigee. |
||
|
Modifica il comportamento della funzionalità del sito |
Di base: utilizza le impostazioni di amministrazione sul portale per modificare/configurare il comportamento del sito. |
Consulta la documentazione di Apigee che inizia qui |
|
Avanzate: crea un modulo personalizzato per modificare qualsiasi comportamento del sito. |
Consulta Creazione di moduli personalizzati nella documentazione di Drupal |
Panoramica del repository Git
Il repository Git per il tuo codice Drupal contiene tutto il codice del tuo portale ed è organizzato utilizzando la seguente struttura.
Nota: modifica solo i contenuti all'interno della directory /sites/all. Se
modifichi contenuti esterni alla directory /sites/all, potresti riscontrare problemi
durante l'upgrade a nuove versioni e potrebbero verificarsi conflitti di unione durante il controllo delle modifiche a
Git.
|
Cartella nel repository Git |
Descrizione |
|---|---|
/profiles/apigee |
Apigee ha gestito moduli e temi, tra cui:
Nota: non modificare i contenuti nella directory /profiles/apigee, altrimenti avrai problemi durante l'upgrade alle nuove versioni e potresti riscontrare conflitti di unione durante il controllo delle modifiche a Git. Per le best practice relative a Drupal, consulta l'articolo Non ha maickerare core. |
/sites/all |
I tuoi moduli e temi Drupal personalizzati. Per informazioni sulla gestione dei contenuti in questa cartella, consulta Aggiungere moduli e temi personalizzati e Sostituire i moduli e i temi del profilo Drupal. Nota: modifica solo i contenuti all'interno della directory /sites/all. |
Accesso al codice
Per accedere al repository di codice in Git, devi eseguire le attività descritte nelle sezioni seguenti:
Vedi anche Come faccio ad accedere al codice sorgente del portale per gli sviluppatori Drupal 7?
Attivazione dell'accesso SSH al server
Prima di poter utilizzare Git per gestire il tuo codice Drupal, devi abilitare SSH per accedere al server caricando una chiave SSH in Pantheon.
Per abilitare l'accesso SSH al server:
- Accedi a Pantheon all'indirizzo https://dashboard.getpantheon.com/.
- Nella dashboard, seleziona Account.
- Seleziona Chiavi SSH nel menu a sinistra.
- Aggiungi la chiave e seleziona Aggiungi chiave.
Se hai bisogno di aiuto, seleziona il link Scopri come generare una chiave SSH.
Accesso al repository di codice in Git
Nota: consulta la panoramica del repository Git per una panoramica della struttura del repository Git.
Per accedere al repository di codice in Git:
- Accedi alla dashboard di Pantheon.
- Dalla pagina principale di Sites, seleziona l'icona del tuo portale.
- L'URL del repository Git viene visualizzato nella pagina a destra di Modalità di connessione, come mostrato nella figura precedente.
- Copia l'URL del repository Git e clonalo nel tuo ambiente di sviluppo locale utilizzando
il comando:
> git clone gitURL sitename
Ad esempio:
> git clone ssh://codeserver.dev.12@codeserver.dev.12.drush.in:2222/~/repository.git devportal
Tutte le modifiche al codice che esegui il push nel repository Git vengono visualizzate immediatamente nell'ambiente Dev del tuo portale.
Deployment del codice negli ambienti dei portali
Per programmare negli ambienti dei tuoi portali:
- Esegui il push degli aggiornamenti del codice a Git, che aggiorna immediatamente l'ambiente Dev.
- Accedi a Pantheon e seleziona il tuo sito.
- Seleziona l'ambiente Dev.
- Seleziona </>Codice nel menu a sinistra per visualizzare un messaggio relativo alla modifica del codice nel Log di commit:
- Seleziona l'ambiente di test nella parte superiore della pagina.
- Se non hai ancora caricato Dev per Test, ti viene chiesto di farlo ora.
- Se hai già un ambiente Test, viene visualizzato un messaggio che indica
che c'è un commit da Dev pronto per il deployment:
- Se hai già inviato un sito all'ambiente Live, puoi facoltativamente selezionare la terza casella di controllo per copiare il database pubblicato e gli eventuali file caricati dagli sviluppatori per il test da Live. Questo è utile se vuoi testare le modifiche al codice rispetto ai dati più recenti disponibili su In tempo reale.
- Seleziona il pulsante Deploy Code from Development (Esegui il deployment del codice dallo sviluppo).
- Testa il portale nell'ambiente di test.
- Apporta eventuali correzioni al codice per l'ambiente Dev ed esegui di nuovo il push dei file su Test per i test.
- Al termine del test, seleziona l'ambiente Live nella parte superiore della pagina.
- Se non hai ancora caricato Test su Dal vivo, ti viene chiesto di farlo adesso.
- Se hai già un ambiente Live, viene visualizzato un messaggio che indica che esiste un commit da Test pronto per il deployment. Esegui il deployment di queste modifiche nello stesso modo in cui ne hai eseguito il deployment per Test da Dev. Al termine del test, esegui il push del codice nell'ambiente Live.
Scopri di più:
- Per questo processo, Pantheon fornisce una serie di articoli in diretta che puoi visualizzare. Uno dei più importanti è l'articolo Utilizzo del flusso di lavoro Pantheon, che offre una panoramica su come sviluppare, testare ed eseguire il push del sito.
Aggiunta di moduli e temi personalizzati
Puoi espandere la funzionalità del portale aggiungendo moduli e temi personalizzati alle cartelle elencate nella seguente tabella.
Nota: modifica solo i contenuti all'interno della directory /sites/all. Se modifichi contenuti esterni alla directory /sites/all, potresti riscontrare conflitti di unione durante il controllo delle modifiche a Git.
| Modulo/Tema | Cartella nel repository Git | Scopri di più (documentazione di Drupal) |
| Moduli personalizzati | sites/all/modules/custom |
Creazione di moduli personalizzati |
| Temi personalizzati | sites/all/themes |
Personalizzazione del
tema Theming Drupal 7 |
Dopo aver aggiunto il modulo o il tema personalizzato nell'ambiente Dev, puoi eseguirne il deployment su Test per i test e quindi nell'ambiente Live per la produzione, come descritto in Deployment del codice negli ambienti dei portali.
Sostituzione di moduli e temi del profilo Drupal
I moduli e i temi nelle seguenti directory sostituiscono i moduli del profilo e i temi Drupal gestiti e distribuiti da Apigee in /profiles/apigee.
Consulta la panoramica del repository Git.
Ad esempio, potresti voler eseguire l'override di un modulo nella distribuzione Apigee Drupal nei seguenti scenari:
- Vuoi utilizzare una versione diversa di un determinato modulo.
- Vuoi implementare un aggiornamento della sicurezza prima della successiva release pianificata di Apigee.
| Modulo/Tema | Cartella nel repository Git | Scopri di più (documentazione di Drupal) |
| Moduli contributi di Drupal |
Nota: i moduli archiviati in |
Moduli che hanno contribuito
Nota: i moduli generati da Drupal in questa directory sostituiscono i moduli equivalenti gestiti e distribuiti da Apigee in |
| Temi inviati da Drupal | sites/all/themes |
Temi a cui hai contribuito
Nota: i temi forniti da Drupal in questa directory sostituiscono i moduli equivalenti gestiti e distribuiti da Apigee in |
Informazioni sul file impostazioni.php
Il settings.php Drupal si impegna nel repository Git a monte del portale per sviluppatori Apigee Drupal. Se vuoi apportare modifiche al file sites/default/settings.php, non modificare direttamente il file.
Crea invece un file denominato sites/default/settings.local.php in cui inserisci il tuo codice personalizzato. Il sites/default/settings.local.php è incluso nel file settings.php.
Ad esempio, quando configuri un dominio personalizzato per un sito pubblicato seguendo le istruzioni fornite da Pantheon, anziché modificare direttamente il file settings.php, aggiungi gli aggiornamenti necessari in sites/default/settings.local.php.
Protezione del portale
Per impostazione predefinita, i siti dei portali associati agli ambienti Dev, Test e Live sono accessibili pubblicamente. Ciò significa che chiunque abbia l'URL del sito può accedervi, ma potrebbe non essere in grado di registrare un account o accedere al sito. Per maggiori informazioni sul controllo della registrazione degli utenti, consulta Aggiungere e gestire account utente.
È probabile che tu voglia nascondere i tuoi siti Dev e Test al pubblico e vuoi nascondere il tuo sito Live fino al termine dello sviluppo. Pantheon ti consente di aggiungere il controllo di nome utente/password per bloccare un sito in modo che solo le persone che dispongono delle credenziali corrette possano accedervi.
Aggiungi il blocco a uno dei tre ambienti selezionando Sicurezza nel menu a sinistra per l'ambiente. Per ulteriori informazioni, consulta la sezione Bloccare il sito.
Se vuoi attivare TLS/SSL per il tuo sito, consulta Utilizzo di TLS sul portale.
Applicazione di un aggiornamento Apigee al tuo portale
Quando Apigee pubblica una nuova release del portale, viene visualizzato un messaggio nella dashboard di Pantheon.
In genere devi applicare l'aggiornamento all'ambiente Dev e poi testare le modifiche nello stesso modo in cui verifichi le modifiche al codice personalizzate. Ad esempio, esegui il push dell'ambiente Dev su Test, esegui il push dei dati in tempo reale da Live a Test, quindi testa l'aggiornamento.
Per applicare un aggiornamento:
- Accedi a Pantheon all'indirizzo https://dashboard.getpantheon.com/ e seleziona il tuo sito.
- Seleziona l'ambiente Dev.
- Seleziona la voce di menu </>Codice a sinistra. Gli eventuali aggiornamenti di Apigee disponibili saranno elencati.
- Applica l'aggiornamento:
-
Seleziona la casella di controllo Esegui update.php dopo aver eseguito il pull del codice.
-
Se disponibile, seleziona la casella di controllo Svuota le cache dopo il pull del codice.
-
Seleziona il pulsante Esegui il deployment del codice.
-
- Al termine dell'aggiornamento, seleziona la voce di menu Stato a sinistra della dashboard.
- Nell'area Stato di un ambiente, potresti notare un errore per l'aggiornamento di un database, come mostrato di seguito:
Se visualizzi questo errore in qualsiasi ambiente, aggiorna manualmente il database:
- Accedi al portale come utente con privilegi di amministratore o per la creazione di contenuti.
- Seleziona l'icona Home > Esegui aggiornamenti nell'angolo in alto a sinistra del portale.
- Segui le istruzioni per aggiornare il database.
- Esegui il push delle modifiche al codice nell'ambiente di test, quindi esegui il push su Live, come descritto sopra.
Migrazione delle funzionalità personalizzate
Se aggiungi funzionalità o codice personalizzato al portale, devi decidere come mantenerli e come spostarli dagli ambienti Dev a Test e Live.
Per il codice nel repository Git, puoi utilizzare il processo descritto in Deployment del codice negli ambienti del portale per eseguire la migrazione del codice da Dev a Test a Live.
Se hai creato configurazioni personalizzate, utilizza uno dei seguenti metodi per eseguirne la migrazione:
| Metodo | Descrizione |
| Esporta la configurazione nel codice | Molte configurazioni comuni sono "esportabili" nel codice mediante il modulo Funzionalità. Ad esempio, visualizzazioni, riquadri, cache delle immagini e così via. |
Implementa la funzione hook_update_N() |
Drupal gestisce le modifiche al database e alla configurazione utilizzando la funzione hook_update_N().
Se disponi di un modulo personalizzato, puoi:
|
Consulta anche Utilizzo del flusso di lavoro Pantheon, che fornisce una panoramica su come sviluppare, testare ed eseguire il push del sito. Questo articolo include la sezione Gestione della configurazione.
Configurazione di un dominio personalizzato
I nomi di dominio forniti da Apigee per un portale predefinito sono apigee.io, come descritto in Gestire gli ambienti, che potrebbero non essere quelli che vuoi mostrare ai tuoi clienti.
I piani del portale a pagamento possono configurare un nome di dominio personalizzato per il portale (gli account sviluppatore o gli account senza costi non possono creare un dominio personalizzato). Per utilizzare un dominio personalizzato, crea un CNAME nel tuo DNS e punta il tuo dominio a edge.apigee.getpantheon.com.
Ad esempio, per configurare il dominio personalizzato per un'azienda denominata Mytech:
- Configura la seguente impostazione DNS:
developer.mytech.com. 3600 IN CNAME edge.apigee.getpantheon.com
L'applicazione di questa modifica al DNS per tutti i dispositivi client può richiedere fino a 48 ore. - Utilizza la voce di menu Domini / SSL sul lato sinistro della dashboard per aggiungere questo dominio alla dashboard di Pantheon solo per l'ambiente Live.
Nella maggior parte dei casi, il DNS viene configurato solo per l'ambiente Live, non per Dev e Test. Non devi utilizzare gli ambienti Dev o Test per la produzione.
Per ulteriori informazioni, consulta la documentazione di Pantheon qui.
Aggiunta di amministratori del portale
Quando riceverai l'email da Apigee che ti informa che il tuo portale è pronto, Apigee avrà già configurato l'elenco degli amministratori del portale. Per visualizzare l'elenco, seleziona il link Team in alto a destra nella dashboard del sito.
Per aggiungere altri amministratori, consulta Creare utenti amministratori.
Backup del portale in corso...
Per eseguire il backup del tuo portale, utilizza la scheda Backup nella dashboard di Pantheon. Puoi creare un backup on demand o automatizzato. In Pantheon, un backup è costituito da tre archivi distinti: database, file e codice.
Per ulteriori informazioni, consulta la sezione Strumento di backup nella documentazione di Pantheon.
Iscrizione agli aggiornamenti di stato
Puoi iscriverti agli aggiornamenti di release e stato di Apigee all'indirizzo status.apigee.com. Fai clic su Iscriviti agli aggiornamenti, inserisci le informazioni di contatto, come l'indirizzo email, quando richiesto, quindi fai clic su Iscriviti. Nella pagina di gestione delle notifiche via email, assicurati che sia selezionata l'opzione Portale per gli sviluppatori, attiva/disattiva altre impostazioni di notifica come necessario e fai clic su Aggiorna preferenze.
Puoi iscriverti agli aggiornamenti dello stato e ai report sugli incidenti di Pantheon, ad esempio in caso di interruzione, all'indirizzo http://status.getpantheon.com. Fai clic su Iscriviti agli aggiornamenti per registrarti.