Installazione del portale Servizi per gli sviluppatori

Portale di Servizi per gli sviluppatori versione 4.16.05

Segui questi passaggi per installare il portale Developer Channel Services.

Prima di procedere con l'installazione, esegui un backup dell'intera directory radice web di Drupal . Il percorso di installazione predefinito è /var/www/html, ma potresti averlo modificato al momento dell'installazione. Dopo aver eseguito la procedura di installazione descritta di seguito, puoi ripristinare personalizzazioni dal backup.

1. Scarica il bundle Channel Services per gli sviluppatori

Vai a http://community.apigee.com/content/apigee-customer-support e seleziona Accedi al tuo Portale di assistenza per richiedere il file .tar di Channel Services per gli sviluppatori in uno dei due modi seguenti:

  • Richiedi l'accesso alla directory di download di Edge per il cloud privato.
  • Richiedi un URL al file .tar di Developer Channel Services.
di Gemini Advanced.

2. Assicurati che il tuo impianto soddisfi i requisiti del sistema requisiti

Prima di installare il portale, il server deve soddisfare i seguenti requisiti:

  1. Assicurati di eseguire l'installazione sulla versione a 64 bit di una versione supportata di Red Hat Enterprise Linux, CentOS o Oracle. Consulta l'elenco delle versioni supportate qui.
  2. Assicurati che Yum sia installato.
  3. (Per un'installazione su un server senza connessione a internet) devi: per prima cosa scaricare tutti i file necessari su un server con una connessione Internet come .tar.gz. Quindi, copio il file .tar.gz sul server senza connessione Internet per eseguire l'installazione.
    1. Accedi a un server con una connessione Internet come utente root o super user.
    2. Crea una directory per i file di installazione, ad esempio portal_tar.
    3. Apri il CD alla nuova directory e scarica il riquadro Developer Channel Services DeveloperServices_x.y.z.tar dove x.y.z corrisponde al numero di versione del portale.
    4. Estrai i contenuti del file .tar di Developer Channel Services utilizzando la proprietà comando:
      &gt; tar -xvf <tar file&gt;
    5. Da CD a DeveloperServices-4.x.y.z.
    6. Crea il file .tar.gz del portale utilizzando questo comando:
      &gt; ./non-networked-install.sh

      Questo comando scarica tutti i file necessari in un unico file .tar.gz. Tu quindi copia il file .tar.gz sul tuo server privo di connessione a Internet per completare installare l'app.
  4. Verifica la tua connessione al server di gestione perimetrale eseguendo il seguente comando cURL da un prompt dei comandi sul server del portale:
    &gt; curl -u {EMAIL}:{PASSWORD} https://{hostname}:8080/v1/organizations/{ORGNAME}

    Dove sono l'indirizzo email EMAIL e PASSWORD indirizzo e password dell'amministratore di ORGNAME.

    Assicurati di specificare il nome host e il numero di porta specifici per la tua installazione di Edge. Porta 8080 è la porta predefinita utilizzata da Edge. Se ti connetti a un'organizzazione nel cloud, l'URL della richiesta è:
    https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}

    Se l'esito è positivo, questo comando restituisce una risposta simile alla seguente:
    {
    "createAt" : 1348689232699,
    "createBy" : "NOME UTENTE",
    &quot;displayName&quot; : "cg",
    "ambienti" : [ "test", "prod" ],
    "lastModificato" : 1348689232699,
    "lastModificatoBy" : "foo@bar.com",
    "nome" : "cg",
    "proprietà" : {
    "proprietà" : [ ]
    },
    "tipo" : "prova"
    }

3. Installa sviluppatore Channel Services che utilizza lo script di installazione automatica

Usa la seguente procedura per installare il portale usando lo script di installazione automatica. Questo funziona per i server con o senza una connessione Internet esterna.

  1. Accedi al server come utente root o super user.
  2. Crea una directory per i file di installazione, ad esempio portal.
  3. Su un server con una connessione a internet:
      .
    1. CD al nuovo portale e scarica il file Developer Channel Services DeveloperServices_x.y.z.tar dove x.y.z corrisponde al numero di versione del portale.

      Puoi scaricare un file dal link inviato da Apigee in un browser o copiarlo per poi aggiungerlo al seguente comando cURL:
      &gt; curl -kOL <paste link here&gt;
    2. Estrai i contenuti del file .tar di Developer Channel Services utilizzando la proprietà comando:
      &gt; tar -xvf <tar file&gt;
    3. Da CD a DeveloperServices-4.x.y.z.
    4. Esegui lo script di installazione utilizzando questo comando:
      &gt; ./networked-install.sh
  4. Su un server senza connessione a internet:
      .
    1. Copia il file .tar.gz che hai creato nella sezione 2 precedente. Assicurati che il tuo sistema soddisfi i requisiti i requisiti di sistema.
    2. Estrai i contenuti del file .tar.gz utilizzando questo comando:
      &gt; tar -xvf <tar file&gt;
    3. da CD alla directory creata dal comando tar.
    4. Imposta le autorizzazioni nello script install-from-rpm-bundle.sh:
      > chmod 755 install-from-rpm-bundle.sh
    5. Esegui lo script install-from-rpm-bundle.sh utilizzando questo comando:
      > ./install-from-rpm-bundle.sh
  5. Rispondi alle richieste.
  6. Al termine dell'installazione, accedi all'URL del server in un browser, ad esempio come:
    http://localhost. Oppure, se hai un IP o un DNS specifico configurato, vai a http://IP_address o http://IP_address.

    Si aprirà la pagina di configurazione del database del profilo Apigee.

    Nota: in genere, devi aver già configurato e registrato un nome host con il tuo server DNS, in modo da non dover utilizzare http://localhost.
  7. Configura la connessione a MySQL. Se MySQL si trova su una macchina remota, espandi la Opzioni avanzate e inserisci le informazioni per la connessione a quel computer. quindi seleziona Salva e continua.
  8. Configura la connessione all'endpoint Apigee inserendo le seguenti informazioni e quindi seleziona Salva:
    Per ulteriori informazioni su questi valori, consultare la sezione "Informazioni richieste prima di avviare l'installazione" nel portale Servizi per gli sviluppatori requisiti.
    1. Organizzazione del portale per sviluppatori
    2. URL endpoint del portale per sviluppatori
    3. Utente autenticato endpoint
    4. Utenti autenticati Password
  9. Quando richiesto, seleziona il pulsante Install Sample SmartDocs WADL (Installa file WADL di esempio) per installare il file WADL SmartDocs di esempio. Se salti questo passaggio, l'API SmartDocs di esempio non appaiono sul tuo portale.
    Nota: se il tuo portale si connette a un'installazione di Apigee Edge per privati Google Cloud e l'installazione di Edge non abbia una connessione a internet esterna, devi eseguire configurazione aggiuntiva del modulo SmartDocs prima di poter utilizzare SmartDocs. Per ulteriori informazioni informazioni su SmartDocs, vedi http://apigee.com/docs/developer-services/content/using-smartdocs-document-apis.
  10. Configura le impostazioni del server SMTP. Apigee richiede la configurazione Server SMTP per inviare messaggi email dal portale.
    Per ulteriori informazioni, vedi http://apigee.com/docs/developer-services/content/configuring-email.
  11. Configura l'utente amministratore inserendo le seguenti informazioni, quindi seleziona Salva. Tieni presente che Drupal ha creato un utente amministratore con il nome "admin". per impostazione predefinita, quindi non usare "admin" come il nome utente.
    Se salti questo passaggio, puoi comunque utilizzare Drush per creare un amministratore come descritto di seguito in 4. Crea un utente amministratore.
    1. Nome e cognome dello sviluppatore
    2. Nome utente del portale per sviluppatori
    3. Password
    4. Indirizzo email
  12. Al termine dell'installazione, imposta le autorizzazioni nel file settings.php:
    > chmod 640 /var/www/html/sites/default/settings.php
  13. Vai alla home page del portale all'indirizzo http://localhost/ o al nome DNS di il tuo portale.
  14. Accedi al portale utilizzando le credenziali dell'amministratore.

4. Creare un utente amministratore

Utilizza Drush per creare un utente amministrativo per la tua installazione di Developer Channel Services. Drupal crea automaticamente un utente amministratore denominato "admin" per impostazione predefinita, quindi non usare "admin" come il nome utente.

  1. CD alla directory drupal_root/sites/default. La posizione standard della radice di Drupal directory è /var/www/html:
    &gt; cd &lt;drupal_root&gt;/sites/default
  2. Assicurati di disporre delle autorizzazioni di scrittura sui file privati Drupal:
    &gt; CANNOT TRANSLATE file_private_path

    Questo comando restituisce il percorso dei file privati Drupal, ad esempio:
    file_private_path: 'sites/default/private'

    Corrisponde a /var/www/html/sites/default/private/. Utilizza il seguente comando per assicurarti che Questa directory è accessibile in scrittura dal proprietario e dal gruppo:
    chmod -R g+w dirPathAndName
    chmod -R o+r dirPathAndName
  3. Inserisci i comandi seguenti per creare un utente amministratore, sostituendo i comandi in "< >" con i tuoi valori:
    &gt; creazione-utente-drush <nome utente> --mail=&quot;&lt;email-address&gt;&quot; --password=&quot;&lt;password&gt;&quot;
    &gt; drush user-add-role Administrator <nome utente>
  4. Accedi al portale per gli sviluppatori come amministratore utilizzando il nome utente e la password specificati in alto.

5. Impostare la password root MySQL

Se hai installato MySQL nell'ambito dell'installazione del portale, lo script di installazione lascia il La password root MySQL è impostata sul suo valore predefinito, che è vuoto.

Utilizza il seguente comando per impostare la password root:

> mysqladmin -u root password NEWPASSWORD

Se hai già impostato la password root e desideri cambiarla, utilizza la seguente :

> mysqladmin -u root -p'OLDPASSWORD' password NEWPASSWORD

Devi anche aggiornare la password nel file /var/www/html/sites/default/settings.php .

6. Assicurati che il modulo Gestore aggiornamenti sia attivata

Per ricevere notifiche relative agli aggiornamenti di Drupal, assicurati che il modulo gestore degli aggiornamenti di Drupal sia in un bucket con il controllo delle versioni attivo. Dal menu Drupal, seleziona Moduli e scorri verso il basso fino Modulo Gestione aggiornamenti. Se non è abilitato, abilitalo.

Una volta attivati, puoi visualizzare gli aggiornamenti disponibili nella sezione Report > Disponibile Voce di menu Aggiornamenti. Puoi anche utilizzare il seguente comando Drush:

> drush pm-info update

Utilizza Report > Aggiornamenti disponibili > Impostazioni per configurare la voce al modulo di inviarti un'email quando sono disponibili aggiornamenti e di impostare la frequenza per la verifica aggiornamenti.

7. (Facoltativo) Deployment in un ambiente di produzione server

Se esegui il deployment del portale su un server di produzione, devi eseguire ulteriori operazioni passaggi, tra cui:

  1. Esegui lo script seguente per proteggere l'installazione di MySQL:
    &gt; /usr/bin/mysql_secure_installation

    Questo script imposta la password root e ti offre la possibilità di limitare l'accesso root solo al localhost e per rimuovere i database di test e l'utente anonimo creati per impostazione predefinita. Esecuzione di questo per i server di produzione è vivamente consigliato.
  2. Se richiesto dai criteri aziendali, abilita e configura SELinux.

8. (Facoltativo) Configura Apache Solr motore di ricerca

Per impostazione predefinita, i moduli Drupal che si connettono al motore di ricerca Apache Solr sono disabilitati di installare il portale. La maggior parte dei portali utilizza il motore di ricerca interno Drupal e, pertanto, non richiedono i moduli Drupal Solr.

Se decidi di utilizzare Solr come motore di ricerca, devi installarlo localmente sul tuo server e poi abilitare e configurare i moduli Drupal Solr sul portale.

Per abilitare i moduli Drupal Solr:

  1. Accedi al tuo portale come utente con privilegi di amministratore o di creazione di contenuti.
  2. Seleziona Moduli nel menu Drupal.
  3. Attiva il modulo Apache Solr Framework e Apache Solr. Modulo di ricerca.
  4. Salva le modifiche.
  5. Configura Solr come descritto all'indirizzo https://drupal.org/node/1999280.

9. Facoltativo - Installa mod_ssl per il supporto HTTPS

Il modulo mod_ssl viene utilizzato da Apache HTTP Server per pubblicare pagine web tramite HTTPS. Se Se vuoi utilizzare HTTPS, usa il seguente comando per installare mod_ssl:

> yum install mod_ssl

Per ulteriori informazioni sulla configurazione del portale per l'utilizzo di SSL, vedi http://apigee.com/docs/developer-services/content/using-ssl-portal.

10. Facoltativo - Installare SmartDocs

SmartDocs ti consente di documentare le tue API sul portale Servizi per sviluppatori in modo da rendere la documentazione dell'API è completamente interattiva. Tuttavia, per utilizzare SmartDocs con il portale, devi prima installare SmartDocs su Edge.

  • Se stai connettendo il portale a un'installazione Edge Cloud, SmartDocs è già installato e non sono necessarie ulteriori configurazioni.
  • Se connetti il portale a un'installazione Edge per il cloud privato, devi assicurarti che SmartDocs è installato su Edge. Per ulteriori informazioni sull'installazione di Edge e SmartDocs, vedi Installare SmartDocs.

Per ulteriori informazioni su SmartDocs, vedi Utilizzo di SmartDocs per documentare per le API.

11. E adesso?

I passaggi successivi dopo l'installazione del portale Servizi per gli sviluppatori sono la configurazione e la personalizzazione per soddisfare le tue esigenze specifiche. La documentazione sul sito web di Apigee contiene tutti i informazioni su configurazione, stile e gestione di un portale. Accedi alla documentazione all'indirizzo http://apigee.com/docs/developer-services/content/what-developer-portal.

Nella tabella seguente sono elencate alcune delle attività più comuni da eseguire dopo l'installazione. e include i link alla documentazione di Apigee, dove puoi trovare ulteriori informazioni:

Attività

Descrizione

Personalizzare il tema

Il tema definisce l'aspetto del portale, inclusi colori, stile e altri gli aspetti visivi.

Personalizza il aspetto

La home page include il menu principale, il messaggio di benvenuto, l'intestazione, il piè di pagina e il titolo.

Aggiungere e gestire gli account utente

Il processo di registrazione controlla il modo in cui i nuovi sviluppatori registrano un account nella portale. Ad esempio, i nuovi sviluppatori hanno accesso immediato al portale? devono essere verificati da un amministratore. Questo processo controlla anche il modo in cui un portale l'amministratore riceve una notifica quando viene creato un nuovo account.

Configurazione email

Il portale invia email in risposta a determinati eventi. Ad esempio, quando un nuovo lo sviluppatore si registra sul portale e quando uno sviluppatore perde la password.

Aggiungere e gestire gli account utente

Aggiungi termini e Pagina delle condizioni che gli sviluppatori devono accettare prima di poterle consentire per accedere al portale.

Aggiungere e gestire gli account utente

Il portale implementa un modello di autorizzazione basato sui ruoli. Prima di consentire agli sviluppatori di registrarsi, definire le autorizzazioni e i ruoli utilizzati dal portale.

Aggiungi blog e post del forum

Il portale dispone del supporto integrato per blog e forum con conversazioni in thread. Definisci le autorizzazioni necessaria per visualizzare, aggiungere, modificare ed eliminare post di blog e forum.

Assicurati di eseguire backup del database

Assicurati di eseguire il backup del database Drupal. Tieni presente che, poiché ogni dell'installazione è diversa, spetta a te stabilire il modo migliore per eseguire il backup per configurare un database.

Configurare un nome host

Se non configuri un nome host nel server DNS, puoi sempre accedere al sito tramite all'indirizzo IP del server. Se vuoi utilizzare un nome host, puoi configurare il DNS per il server, che dovrebbe funzionare correttamente senza alcuna altra configurazione in una configurazione di base.

Se configuri un bilanciatore del carico o ricevi URL errati sul tuo sito per alcuni Per un altro motivo, puoi impostare $base_url nel file settings.php del portale per sviluppatori, che per impostazione predefinita si trova nella directory /var/www/html/sites/default .