Cette page a été traduite par l'API Cloud Translation.

Installation du portail de services pour les développeurs

Edge pour Private Cloud v4.18.01

Avant l'installation, vérifiez les points suivants:

Vous installez Postgres avant d'installer le portail. Vous pouvez soit installer Postgres d'installer Edge, ou d'installer Postgres en version autonome pour une utilisation par le portail.
- Si vous installez la version autonome de Postgres, celle-ci peut se trouver sur le même nœud que le portail.
- Si vous vous connectez à Postgres installé dans le cadre d'Edge et que Postgres est configuré en mode maître/veille, spécifiez l'adresse IP du serveur Postgres maître.
Vous effectuez l'installation sur la version 64 bits d'une version compatible de Red Hat Enterprise Linux, CentOS ou Oracle. Consultez la liste des versions compatibles à l'adresse Logiciels et versions compatibles
Yum est installé.

Le programme d'installation n'inclut que les modules fournis par Drupal qui sont requis par le Portail Apigee Developer Services (ou simplement le portail). Pour plus d'informations sur l'installation d'autres modules auxquels vous avez contribué, consultez Extension de Drupal 7

Présentation de l'installation

Après avoir installé l'utilitaire Edge apigee-setup sur un nœud, utilisez pour installer le portail sur le nœud. L'utilitaire apigee-setup se présente comme suit:

sudo /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

Transmettez à l'utilitaire apigee-setup un fichier de configuration contenant le des informations sur l'installation. Si le fichier de configuration ne contient pas d'informations, le apigee-setup vous invite à le saisir dans la ligne de commande.

La seule condition requise est que le fichier de configuration doit être accessible ou lisible par "apigee" utilisateur.

Par exemple, utilisez la commande suivante pour installer le portail:

sudo /opt/apigee/apigee-setup/bin/setup.sh -p dp -f myConfig

Consultez la section Installer l'utilitaire de configuration Edge apigee. pour en savoir plus.

Abandon de la propriété SMTPSSL

Dans les versions précédentes, vous utilisiez la propriété SMTPSSL pour effectuer les opérations suivantes : définir le protocole utilisé par le serveur SMTP connecté au portail. Cette propriété a été obsolète.

Vous utilisez maintenant la propriété SMTP_PROTOCOL. au lieu de la propriété SMTPSSL, pour définir utilisé par le serveur SMTP connecté au portail. Les valeurs valides sont : "standard", "ssl" ou "tls".

Créer un fichier de configuration

Vous trouverez ci-dessous un exemple de fichier de configuration silencieuse pour l'installation d'un portail. Modifier ce fichier selon les besoins de votre configuration. Utilisez l'option -f pour setup.sh pour inclure ceci .

Remarque:Ne définissez pas DEVPORTAL_ADMIN_USERNAME=admin. La admin compte utilisateur est créé par défaut. Si cette valeur est spécifiée, un message d'erreur est renvoyé. vous invitant à configurer un autre nom d'utilisateur.

IP1=IPorDNSnameOfNode

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Specify the name of the portal database in Postgres.
PG_NAME=devportal 

# Specify the Postgres admin credentials.
# The portal connects to Postgres by using the 'apigee' user.
# If you changed the Postgres password from the default of 'postgres'
# then set PG_PWD accordingly.
# If connecting to a Postgres node installed with Edge,
# contact the Edge sys admin to get these credentials.
PG_USER=apigee
PG_PWD=postgres

# The IP address of the Postgres server.
# If it is installed on the same node as the portal, specify that IP.
# If connecting to a remote Postgres server,specify its IP address.
PG_HOST=$IP1

# The Postgres user credentials used by the portal 
# to access the Postgres database, 
# This account is created if it does not already exist. 
DRUPAL_PG_USER=drupaladmin 
DRUPAL_PG_PASS=portalSecret 

# Specify 'postgres' as the database. 
DEFAULT_DB=postgres 

# Specify the Drupal admin account details. 
# DO NOT set DEVPORTAL_ADMIN_USERNAME=admin. 
# The installer creates this user on the portal. 
DEVPORTAL_ADMIN_FIRSTNAME=firstName 
DEVPORTAL_ADMIN_LASTNAME=lastName 
DEVPORTAL_ADMIN_USERNAME=userName 
DEVPORTAL_ADMIN_PWD=pWord 
DEVPORTAL_ADMIN_EMAIL=foo@bar.com 

# Edge connection details. 
# If omitted, you can set them in the portal UI. 
# Specify the Edge organization associated with the portal. 
EDGE_ORG=edgeOrgName 

# Specify the URL of the Edge management API. 
# For a Cloud based installation of Edge, the URL is: 
# https://api.enterprise.apigee.com/v1 
# For a Private Cloud installation, it is in the form: 
# http://<ms_ip_or_DNS>:8080/v1 or 
# https://<ms_ip_or_DNS>:TLSport/v1 
MGMT_URL=https://api.enterprise.apigee.com/v1 

# The org admin credentials for the Edge organization in the form
# of Edge emailAddress:pword. 
# The portal uses this information to connect to Edge. 
DEVADMIN_USER=orgAdmin@myCorp.com 
DEVADMIN_PWD=pWord 

# The PHP port. 
# If omitted, it defaults to 8888. 
PHP_FPM_PORT=8888 

# Optionally configure the SMTP server used by the portal. 
# If you do, the properties SMTPHOST and SMTPPORT are required. 
# The others are optional with a default value as notated below. 
# SMTP hostname. For example, for the Gmail server, use smtp.gmail.com. 
SMTPHOST=smtp.gmail.com 

# Set the SMTP protocol as "standard", "ssl", or "tls",
# where "standard" corresponds to HTTP.
# Note that in previous releases, this setting was controlled by the 
# SMTPSSL property. That property has been deprecated. 
SMTP_PROTOCOL="standard" 

# SMTP port (usually 25). 
# The value can be different based on the selected encryption protocol. 
# For example, for Gmail, the port is 465 when using SSL and 587 for TLS. 
SMTPPORT=25 

# Username used for SMTP authentication, defaults is blank. 
SMTPUSER=your@email.com 

# Password used for SMTP authentication, default is blank. 
SMTPPASSWORD=yourEmailPassword

1. Tester votre connexion à Apigee Edge

Testez votre connexion au serveur de gestion Edge en exécutant la commande cURL suivante à partir d'une invite de commande sur le serveur du portail:

curl -u {EMAIL}:{PASSWORD} http://<ms_ip_or_DNS>:8080/v1/organizations/{ORGNAME}

ou :

curl -u {EMAIL}:{PASSWORD} https://<ms_ip_or_DNS>:TLSPort/v1/organizations/{ORGNAME}

Où EMAIL et PASSWORD sont l'adresse e-mail adresse et mot de passe de l'administrateur de ORGNAME.

Veillez à spécifier le nom d'hôte et le numéro de port spécifiques à votre installation d'Edge. Port 8080 est le port par défaut utilisé par Edge. Si vous vous connectez à une organisation dans le cloud, l'URL de la requête est https://api.enterprise.apigee.com/v1/organizations/ORGNAME.

Si la commande est bien exécutée, elle renvoie une réponse semblable à la suivante:

{
  "createdAt" : 1348689232699,
  "createdBy" : "USERNAME",
  "displayName" : "cg",
  "environments" : [ "test", "prod" ],
  "lastModifiedAt" : 1348689232699,
  "lastModifiedBy" : "foo@bar.com",
  "name" : "cg",
  "properties" : {
    "property" : [ ]
  },
  "type" : "trial"
}

2. Suppression des versions de PHP antérieures à la version 7.0

Le script d'installation vérifie la présence de versions de PHP antérieures à la version 7.0 sur le système avant de lancer le l'installation. S'il existe des versions de PHP antérieures à la version 7.0, le message d'avertissement suivant s'affiche:

The following packages present on your system conflict with software we are
about to install. You will need to manually remove each one, then re-run this install script.

php
php-cli
php-common
php-gd
php-mbstring
php-mysql
php-pdo
php-pear
php-pecl-apc
php-process
php-xml

Supprimez les packages PHP à l'aide de la commande suivante:

yum remove package-name

3. Installer Postgres

Le portail nécessite l'installation de Postgres avant de pouvoir installer le portail. Vous pouvez soit installer Postgres dans le cadre de l'installation d'Edge ou installez la version autonome de Postgres portail.

Si vous vous connectez à Postgres installé dans le cadre d'Edge et que Postgres est configuré dans maître/veille, spécifiez l'adresse IP du serveur Postgres maître.
Si vous installez la version autonome de Postgres, celle-ci peut se trouver sur le même nœud que le portail.

Pour plus d'informations sur l'installation de Postgres dans le cadre de l'installation d'Edge, consultez Installez les composants Edge sur un nœud.

Pour installer la version autonome de Postgres:

Installez l'utilitaire Edge apigee-setup sur le nœud à l'aide de la méthode sur Internet ou hors Internet. Voir Installez l'utilitaire de configuration Edge Apigee pour en savoir plus.

Créez un fichier de configuration pour Postgres, comme indiqué ci-dessous:

# Must resolve to IP address or DNS
    name of host - not to 127.0.0.1 or localhost.
    HOSTIP=$(hostname -i)

    # The pod and region of Postgres. Use the default values shown below.
    MP_POD=gateway
    REGION=dc-1

    # Set the Postgres password. The default value is 'postgres'.
    PG_PWD=postgres

Dans l'invite de commande, exécutez le script d'installation pour installer Postgres:
```
/opt/apigee/apigee-setup/bin/setup.sh -p pdb -f configFile
```
L'option -p pdb spécifie d'installer Postgre. Le fichier de configuration être accessible ou lisible par "apigee" utilisateur.

4. Installer le portail

Pour installer le portail:

Installez l'utilitaire Edge apigee-setup sur au nœud à l'aide d'une procédure Internet ou hors Internet. Voir Installez l'utilitaire de configuration Edge apigee pour plus encore.
Assurez-vous d'avoir installé Postgres, soit la version autonome de Postgres soit installation d'Edge.
Dans l'invite de commande, exécutez le script de configuration:
```
/opt/apigee/apigee-setup/bin/setup.sh -p dp -f configFile
```
L'option -p dp spécifie d'installer le portail.
Le fichier de configuration doit être accessible ou lisible par "apigee" utilisateur.
Accédez à la page d'accueil du portail à l'adresse http://localhost:8079 ou au nom DNS de votre portail.
Connectez-vous au portail à l'aide des identifiants d'administrateur que vous avez définis dans le fichier de configuration pour s'assurer que le portail fonctionne correctement.
Sélectionnez Rapports > d'état dans le menu Drupal pour vous assurer pour connaître l'état actuel du portail.

5. Assurez-vous que le module du gestionnaire de mises à jour est activé

Pour recevoir des notifications de mises à jour Drupal, assurez-vous que le module du gestionnaire de mises à jour Drupal est est activé. Dans le menu Drupal, sélectionnez Modules et faites défiler vers le bas Gestionnaire de mises à jour. Si ce n'est pas le cas, activez-la.

Une fois les mises à jour activées, vous pouvez les consulter en cliquant sur Rapports > Disponible Mises à jour. Vous pouvez également utiliser la commande Drush suivante:

drush pm-info update

Vous devez exécuter cette commande à partir du répertoire racine du site. Par défaut, Le portail est installé à l'adresse /opt/apigee/apigee-drupal/wwwroot. Par conséquent, vous devez d'abord remplacer le répertoire par /opt/apigee/apigee-drupal/wwwroot avant en exécutant la commande. Si vous n'avez pas installé le portail dans le répertoire par défaut, accédez à votre d'installation.

Utilisez le menu Rapports > Mises à jour disponibles > Élément de menu "Paramètres" à configurer au module de vous envoyer un e-mail lorsque des mises à jour sont disponibles et de définir la fréquence de vérification mises à jour.

6. Configurer le moteur de recherche Apache Solr (Facultatif)

Par défaut, les modules Drupal qui se connectent au moteur de recherche Apache Solr sont désactivés lorsque vous installez le portail. La plupart des portails utilisent le moteur de recherche interne Drupal et n'utilisent donc pas nécessitent les modules Drupal Solr.

Si vous décidez d'utiliser Solr comme moteur de recherche, vous devez installer Solr localement sur votre serveur. puis activer et configurer les modules Drupal Solr sur le portail.

Pour activer les modules Drupal Solr:

Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
Sélectionnez Modules dans le menu Drupal.
Activez le module Apache Solr Framework et Apache Solr de recherche.
Enregistrez les modifications.
Configurez Solr comme décrit dans https://drupal.org/node/1999280.

7. Installer SmartDocs (facultatif)

SmartDocs vous permet de documenter vos API sur le portail de services pour les développeurs de manière à rendre documentation de l'API entièrement interactive. Toutefois, pour utiliser SmartDocs avec le portail, vous devez au préalable installer SmartDocs sur Edge.

Si vous connectez le portail à une installation Edge Cloud, SmartDocs est déjà et qu'aucune configuration supplémentaire n'est nécessaire.
Si vous connectez le portail à une installation Edge pour Private Cloud, vous devez vous assurer que SmartDocs est installé sur Edge. Pour plus d'informations sur l'installation de Edge et SmartDocs, voir Installez SmartDocs.

Vous devez également activer SmartDocs sur le portail. Pour plus d'informations sur SmartDocs, consultez Utilisation de SmartDocs pour documenter API.

8. Configurez les Module JQuery Update pour les installations hors Internet (facultatif)

Si vous installez et utilisez le module JQuery Update dans une installation autre qu'Internet, vous devez configurer le module pour qu'il utilise la version locale de JQuery. Si vous configurez le module pour utiliser un CDN pour une installation hors connexion, il tentera d'accéder au CDN, ce qui entraînera des retards de chargement chargement en cours. Pour en savoir plus sur le module JQuery Update, consultez la page https://www.drupal.org/project/jquery_update.

Pour configurer le module JQuery Update afin qu'il utilise la version locale de JQuery:

Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
Sélectionnez Configuration > Développement > JQuery Update dans le menu Drupal.
Cliquez sur Performances dans le panneau de navigation de gauche.
Dans le menu déroulant "JQuery and JQuery UI CDN" (CDN de l'interface utilisateur JQuery et JQuery), sélectionnez None (Aucun).
Cliquez sur Enregistrer la configuration.

9. Et maintenant ?

Une fois que vous avez installé le portail de services pour les développeurs, les étapes suivantes consistent à configurer et à personnaliser en fonction de vos besoins spécifiques. La documentation sur le site Web d'Apigee contient toutes les des informations sur la configuration, le style et la gestion d'un portail. Accédez à la documentation à l'adresse http://apigee.com/docs/developer-services/content/what-developer-portal.

Le tableau suivant répertorie certaines des tâches les plus courantes que vous effectuez après l'installation, et inclut des liens vers la documentation Apigee où vous pouvez trouver plus d'informations:

Tâche	Description
Personnaliser le thème	Le thème définit l'apparence du portail, y compris les couleurs, le style et d'autres les aspects visuels.
Personnalisez les apparence	La page d'accueil comprend le menu principal, le message de bienvenue, l'en-tête, le pied de page et le titre.
Ajoutez et gérer les comptes utilisateur	Le processus d'inscription détermine la façon dont les nouveaux développeurs créent un compte sur le portail. Par exemple, les nouveaux développeurs obtiennent-ils un accès immédiat au portail, doivent être vérifiées par un administrateur. Ce processus contrôle également la façon dont un portail administrateur est averti lorsqu'un compte est créé.
Configuration adresse e-mail	Le portail envoie des e-mails en réponse à certains événements. Par exemple, lorsqu'un nouveau développeur s'inscrit sur le portail et quand un développeur perd son mot de passe.
Ajoutez et gérer les comptes utilisateur	Ajouter un champ "Conditions d'utilisation" Page des conditions que les développeurs doivent accepter avant d'être autorisés à le faire accéder au portail.
Ajoutez et gérer les comptes utilisateur	Le portail implémente un modèle d'autorisation basé sur les rôles. Avant de permettre aux développeurs enregistrer, définir les autorisations et les rôles utilisés par le portail.
Ajouter un blog et posts sur le forum	Le portail prend en charge les blogs et les forums thématiques. Définir les autorisations nécessaire pour afficher, ajouter, modifier et supprimer des messages de blogs et de forums.
Assurez-vous d'effectuer des sauvegardes de base de données	Assurez-vous de sauvegarder la base de données Drupal. Comme chaque d'installation est différente, c'est à vous de déterminer la meilleure façon de sauvegarder base de données. Remarque: Le module Sauvegarde et migration n'est pas compatible avec Postgres les bases de données. Consultez également l'article Effectuer une sauvegarde.
Configurer un nom d'hôte	Si vous ne configurez pas de nom d'hôte sur votre serveur DNS, vous pouvez toujours accéder au site via l'adresse IP du serveur. Si vous souhaitez utiliser un nom d'hôte, vous pouvez configurer le DNS pour le serveur, qui devrait fonctionner correctement sans aucune autre configuration sur une configuration de base. Si vous configurez un équilibreur de charge ou que vous obtenez des URL incorrectes sur votre site pour certains vous pouvez définir `$base_url` pour Drupal en procédant comme suit: Créer le répertoire `/opt/apigee/data/apigee-drupal-devportal/sites/default/includes` s'il n'existe pas. Créez un fichier nommé `settings.php` dans ce répertoire. Ajoutez le code suivant au fichier `settings.php`: /** * Base URL (optional). * * If Drupal is generating incorrect URLs on your site, which could * be in HTML headers (links to CSS and JS files) or visible links * on pages (such as in menus), uncomment the Base URL statement * below (remove the leading hash sign) and fill in the absolute URL * to your Drupal installation. * * You might also want to force users to use a given domain. * See the .htaccess file for more information. * * Examples: * $base_url = 'http://www.example.com'; * $base_url = 'http://www.example.com:8888'; * $base_url = 'http://www.example.com/drupal'; * $base_url = 'https://www.example.com:8888/drupal'; * * It is not allowed to have a trailing slash; Drupal will add it * for you. */ # $base_url = 'http://www.example.com/'; // NO trailing slash! $base_url = ‘http://www.example.com’; Remplacez la dernière ligne `$base_url` par le nom d'hôte de votre site. Enregistrez le fichier. Notez que vous pouvez placer n'importe quel autre paramètre de `/opt/apigee/data/apigee-drupal-devportal/ sites/default/default.settings.php` dans ce fichier. Pour en savoir plus sur la propriété `$base_url`, consultez les pages suivantes: https://codeburst.io/security-for-drupal-and-related-server-software-3c979b041595 https://www.drupal.org/node/1992030
Développement personnalisé	Vous pouvez également étendre les capacités de votre portail avec du code personnalisé en dehors de votre d'un thème. Pour ce faire, créez votre propre module Drupal, comme décrit dans le le module développement, puis placez le module dans le `/sites/all/modules` .