Collaborare con Acquia

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

Apigee utilizza Acquia, un servizio di gestione dei siti web, per l'hosting di versioni basate su cloud del portale di Servizi per gli sviluppatori. Acquia è progettato per collaborare con Drupal per consentirti di sviluppare, testare e pubblicare il tuo portale in un ambiente sicuro.

Le seguenti sezioni descrivono come utilizzare Acquia per sviluppare e gestire il tuo portale.

Accesso all'interfaccia di Acquia Cloud

Dopo aver configurato il tuo account Acquia Cloud, puoi accedere al portale tramite l'interfaccia di Acquia Cloud all'indirizzo https://cloud.acquia.com/.

Al primo accesso, viene visualizzata la pagina Applicazioni, come mostrato nella figura che segue.

La pagina Applicazioni mostra tutte le applicazioni a cui hai accesso che sono ospitate su Acquia Cloud. Un'applicazione è l'entità software che gestisci in Acquia Cloud, ad esempio il sito del portale basato su Drupal.

Le seguenti sezioni descrivono come utilizzare l'interfaccia di Acquia Cloud per gestire i contenuti del portale.

Per ulteriori informazioni sull'interfaccia di Acquia Cloud, consulta Accesso all'interfaccia di Acquia Cloud e Gestione delle applicazioni con Acquia Cloud nella documentazione di Acquia Cloud.

Gestione degli ambienti

Accedi all'interfaccia di Acquia Cloud e nella pagina Applicazioni fai clic su Gestisci associato al sito del tuo portale per accedere alla relativa dashboard.

Per gestire il tuo flusso di lavoro, sono disponibili tre ambienti per lo sviluppo, il test e la pubblicazione del portale, come descritto nella tabella seguente. Il portale è stato sottoposto a deployment in ciascun ambiente, ma potrebbe essere in uno stato diverso con un ramo o tag di codice univoco, un database e così via. Vedi Deployment del codice negli ambienti dei portali.

Ambiente	Descrizione	URL predefinito
Sviluppatori	Sviluppa nuove funzionalità e personalizza il portale.	http://{application-name}xxxxxx.devcloud.acquia-sites.com/ Dove application-name è il nome della tua applicazione e xxxxxx è una stringa univoca di caratteri utilizzata per distinguere Dev e Stage.
Palcoscenico	Testa il codice più recente prima di eseguirne il push nell'ambiente di produzione.	http://{application-name}yyyyyy.devcloud.acquia-sites.com/ Dove application-name è il nome della tua applicazione e yyyyyy è una stringa univoca di caratteri utilizzata per distinguere Dev e Stage.
Prodotto	Pubblica il portale in produzione (in tempo reale).	http://{application-name}.devcloud.acquia-sites.com/ Dove application-name è il nome della tua applicazione. Nota: vedi anche Configurare un dominio personalizzato.

Per ulteriori informazioni, consulta la sezione Utilizzo degli ambienti nella documentazione di Acquia Cloud.

Sviluppo del portale

Le sezioni seguenti descrivono come sviluppare il portale.

• Panoramica del repository Git
• Accesso al codice
• Deployment del codice negli ambienti dei portali
• Aggiungere moduli e temi personalizzati
• Sostituire i moduli e i temi del profilo 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.	Vedi Personalizzazione del tema
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: /profiles/apigee/modules/contrib: moduli di contributo Drupal gestiti da Apigee /profiles/apigee/themes/contrib: temi di contributo Drupal gestiti da Apigee /profiles/apigee/modules/custom: moduli personalizzati creati da Apigee /profiles/apigee/themes/custom: temi personalizzati creati da Apigee 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:

• Attivazione dell'accesso SSH al server
• Accesso al repository di codice in Git

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. Per ulteriori informazioni, consulta Abilitazione dell'accesso SSH nella documentazione di Acquia Cloud.

Per attivare l'accesso SSH:

1. Accedi all'interfaccia degli account Acquia all'indirizzo https://accounts.acquia.com.
2. Fai clic su Credenziali.
3. Se richiesto, reinserisci la password per confermare la tua identità.
4. Nella sezione Chiavi SSH, fai clic su Aggiungi chiave SSH.
5. Immetti le seguenti informazioni:

   Campo	Descrizione
   Nickname	Nickname per la chiave SSH. Il nickname può contenere caratteri alfanumerici e trattini bassi.
   Chiave pubblica	Chiave pubblica. Per informazioni sulla generazione di una chiave pubblica SSH, consulta Generazione di una chiave pubblica SSH nella documentazione di Acquia Cloud.

6. Fai clic su Aggiungi chiave.

Accesso al repository di codice in Git

Il repository Git contiene tutto il codice del sito del portale. Puoi aggiungere nuovo codice o personalizzare quello esistente per configurare il tuo portale. Per ulteriori informazioni, consulta la sezione sull'utilizzo del repository di codice nella documentazione di Acquia Cloud.

Per accedere al repository di codice nel repository Git:

1. Accedi all'interfaccia di Acquia Cloud all'indirizzo https://cloud.acquia.com/.
2. Nella pagina Applicazioni, fai clic su Gestisci per visualizzare i dettagli del portale.
3. Fai clic su Informazioni applicazione nella barra di navigazione.

   

4. Copia il comando clone nella finestra di dialogo Informazioni sull'applicazione.
5. Clona il repository Git nel tuo ambiente locale eseguendo uno dei seguenti comandi Git:

   Per clonare il repository Git e creare un nuovo ramo:

   > git clone --branch [branch] myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

   Per clonare il repository Git dal ramo master:

   > git clone myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

6. Ripeti questi passaggi quando è tutto pronto per l'archiviazione, il commit e il push delle modifiche nel repository Git utilizzando i comandi pertinenti mostrati nella finestra dell'applicazione.
   

   Quando esegui il commit di un ramo nel tuo repository, Acquia Cloud aggiorna l'ambiente che esegue quel ramo di codice. Puoi eseguire il deployment del codice negli ambienti dei portali, come descritto nella sezione successiva.

Deployment del codice negli ambienti dei portali

Per eseguire il deployment, cambiare o ripristinare il codice in un ambiente portale, sposta il codice tra gli ambienti o scopri di più sulla struttura del repository e sul flusso di lavoro consigliato, consulta Utilizzo di siti su Aquia Cloud nella documentazione di Acquia Cloud. Quando esegui il deployment di nuovo codice in un ambiente, devi eseguire update.php per apportare gli aggiornamenti richiesti al database.

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	Personalizzare il 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	sites/all/modules/contrib Nota: i moduli archiviati in /sites/all/modules eseguiranno l'override dei moduli di distribuzione Apigee Drupal.	Moduli che hanno contribuito Nota: i moduli generati da Drupal in questa directory sostituiscono i moduli equivalenti gestiti e distribuiti da Apigee in /profiles/apigee/modules. Rimuovi eventuali moduli duplicati che hai aggiunto a questa cartella se vuoi utilizzare i moduli del profilo Drupal gestiti da Apigee.
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 /profiles/apigee/themes. Rimuovi eventuali moduli duplicati che hai aggiunto a questa cartella se vuoi utilizzare i temi del profilo gestiti da Apigee.

Abilitazione dell'SSL

Per attivare l'accesso sicuro al tuo sito utilizzando HTTPS, devi attivare SSL.

Per attivare SSL:

1. Ottieni un certificato SSL da un'autorità di certificazione (CA) o da un fornitore di certificati SSL. Vedi Attivazione di SSL.
2. Carica il certificato SSL nella pagina SSL dell'interfaccia di Acquia Cloud. Vedi Gestione dei certificati SSL.

Protezione dell'ambiente di produzione

Quando crei un'applicazione per la prima volta, puoi gestire liberamente l'ambiente di produzione e propagare le modifiche dagli ambienti di sviluppo e gestione temporanea. Dopo aver pubblicato i contenuti, ti consigliamo di bloccare l'ambiente di produzione per evitare aggiornamenti non autorizzati o accidentali dei contenuti. Per ulteriori informazioni, consulta la sezione sull'utilizzo della modalità di produzione per proteggere l'applicazione in tempo reale nella documentazione di Acquia Cloud.

Per proteggere l'ambiente di produzione:

1. Accedi all'interfaccia di Acquia Cloud all'indirizzo https://cloud.acquia.com/.
2. Nella pagina Applicazioni, fai clic su Gestisci per visualizzare i dettagli del sito del tuo portale.
3. Fai clic su Prod per visualizzare i dettagli dell'ambiente di produzione.
4. Fai clic su Modalità di produzione nella barra di navigazione.
5. Fai clic su Attiva per attivare la modalità di produzione.

Applicazione degli aggiornamenti di moduli e temi al portale

Periodicamente, Apigee aggiorna automaticamente i moduli e i temi del portale all'ultima versione. Gli aggiornamenti vengono effettuati solo nell'ambiente Dev e vengono applicati tag per indicare che è necessario eseguire la migrazione ad altri ambienti di portali.

Se il tuo sito non fa parte dell'organizzazione di fatturazione Apigee Acquia (ad esempio, un nuovo sito migrato da un altro provider host alla tua organizzazione) devi consentire ad Apigee di accedere al tuo repository Git per ricevere push automatici di aggiornamenti per il portale per gli sviluppatori. Contatta l' assistenza Apigee per ulteriori informazioni.

Se hai aggiunto moduli o temi personalizzati, dovrai aggiornarli manualmente.

La seguente tabella riassume i passaggi necessari per applicare gli aggiornamenti di moduli e temi al portale.

Moduli/Temi	Descrizione
Moduli Apigee Edge	Apigee applica automaticamente gli aggiornamenti solo all'ambiente Dev. Dopo aver testato gli aggiornamenti, eseguine la migrazione dagli ambienti Dev a Stage e Prod, come descritto in Deployment del codice negli ambienti del portale.
Tema adattabile Apigee	Apigee applica automaticamente gli aggiornamenti solo all'ambiente Dev. Dopo aver testato gli aggiornamenti, eseguine la migrazione dagli ambienti Dev a Stage e Prod, come descritto in Deployment del codice negli ambienti del portale.
Moduli principali e contributi di Drupal	Apigee applica automaticamente gli aggiornamenti solo all'ambiente Dev. Dopo aver testato gli aggiornamenti, eseguine la migrazione dagli ambienti Dev a Stage e Prod, come descritto in Deployment del codice negli ambienti del portale.
Moduli e temi personalizzati	Se hai aggiunto moduli e temi personalizzati al portale, come descritto in Aggiungere moduli e temi personalizzati, devi installare gli aggiornamenti manualmente. Scarica la versione più recente nella directory locale manualmente o utilizzando Drush. Quindi, esegui il deployment degli aggiornamenti, esegui il commit e il push nel repository Git. Dopo aver testato gli aggiornamenti, eseguine la migrazione dagli ambienti Dev a Stage e Prod, come descritto in Deployment del codice negli ambienti del portale.

Migrazione delle funzionalità personalizzate

Se aggiungi configurazioni o codice personalizzato al portale, devi gestirli ed eseguirne la migrazione dagli ambienti Dev a Stage e Prod.

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 Stage a Prod.

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: Aggiungi funzioni hook_update_N() al file .install del modulo per elaborare le modifiche. Esegui il deployment di queste modifiche insieme al codice. Esegui update.php per eseguire la migrazione delle modifiche negli ambienti Stage e Prod.

Configurazione di un dominio personalizzato

Come indicato in Gestione degli ambienti, i nomi di dominio predefiniti per gli ambienti dei portali terminano tutti con acquia-sites.com. Ti consigliamo di fornire un nome di dominio personalizzato che permetta di personalizzare e trasmettere meglio lo scopo del tuo sito. Ad esempio, un'alternativa popolare è:

https://developers.mycompany.com

Per configurare un dominio personalizzato:

1. Aggiungi il tuo dominio all'ambiente del sito del portale. Vedi Gestione dei domini nella documentazione di Acquia Cloud.
2. Configura il tuo dominio personalizzato con il tuo provider DNS puntando la voce del record DNS del tuo nome di dominio all'indirizzo IP pubblico (non a un dominio acquia-sites.com). Consulta la sezione relativa al reindirizzamento dei record DNS ai tuoi indirizzi IP pubblici nella documentazione di Acquia Cloud.

   Nota: non impostare la voce CNAME del nome di dominio su un dominio acquia-sites.com. Ciò potrebbe causare problemi di latenza o tempi di inattività del sito del tuo portale.

Monitoraggio del portale con Acquia Insight

Acquia Insight è un insieme di strumenti che ti consentono di ottimizzare il sito del tuo portale monitorandone le prestazioni, la sicurezza e l'ottimizzazione per i motori di ricerca. Per ulteriori informazioni, consulta Acquia Insight.

Backup del portale in corso...

Le seguenti tabelle riepilogano le opzioni disponibili per il backup dei componenti del portale.

Componente	Dettagli backup	Maggiori informazioni nei documenti di Acquia Cloud
Codice	Il codice è gestito da un sistema di controllo della versione e codificato ogni volta che esegui il commit. Sincronizza o ripristina un tag specifico in qualsiasi momento.	Backup del codice
Database	I backup giornalieri vengono eseguiti e conservati per tre giorni. Pianifica backup automatici e on demand. Gli snapshot di emergenza interni di tutti i dati vengono acquisiti ogni ora.	Backup dei database Utilizzo dei job pianificati per gestire l'applicazione
Files	Esegui backup manuali o pianifica un cron job.	Backup dei file Utilizzo dei job pianificati per gestire l'applicazione
Applicazione completa	Esegui il backup manuale utilizzando Drush. .	Backup completi delle applicazioni Utilizzo dei job pianificati per gestire l'applicazione
File system Drupal	Esegui backup manuali utilizzando una delle seguenti opzioni: Copia i file utilizzando un client FTP o strumenti a riga di comando (rsync e scp). Crea un archivio compresso utilizzando Drush. Nota: il modulo Backup e migrazione non è supportato su Acquia Cloud. Per maggiori informazioni, consulta Modulo di backup e migrazione non supportato su Acquia Cloud.	Backup del file system Drupal Utilizzo dei job pianificati per gestire l'applicazione

Visualizzazione delle notifiche delle attività

Puoi visualizzare le notifiche delle attività per tenere traccia delle azioni significative che si verificano sul sito del portale, come l'installazione o la copia di codice tra ambienti, gli aggiornamenti e i backup del database, le modifiche al server e altro ancora. Per ulteriori informazioni, consulta la sezione Visualizzazione delle notifiche di attività nella documentazione di Acquia Cloud.

Per visualizzare l'elenco delle notifiche:

1. Accedi all'interfaccia di Acquia Cloud all'indirizzo https://cloud.acquia.com/.
2. Nella pagina Applicazioni, fai clic su Gestisci per visualizzare i dettagli del sito del tuo portale.
3. Fai clic sull'icona a forma di campana nell'angolo in alto a destra della barra di navigazione per visualizzare le notifiche più recenti.

   

4. Fai clic sulla freccia accanto a una notifica per visualizzare ulteriori informazioni sull'attività.

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 di Acquia per ricevere notifiche su eventuali interruzioni del servizio, manutenzione di emergenza o aggiornamenti della sicurezza apportati alla piattaforma. Per iscriverti agli aggiornamenti di Acquia Cloud:

1. Vai alla pagina Acquia Status.
2. Fai clic su Iscriviti agli aggiornamenti.
3. Seleziona il metodo che desideri utilizzare per ricevere gli aggiornamenti (email, SMS e così via).
4. Nella pagina Notifiche, seleziona i prodotti per cui vuoi ricevere gli aggiornamenti dello stato. ad esempio Acquia Cloud Enterprise.
5. Fai clic su Aggiorna preferenze.