Esta página foi traduzida pela API Cloud Translation.

Instalação do portal de serviços para desenvolvedores

Edge para nuvem privada v4.18.01

Antes de instalar, verifique se:

Instale o Postgres antes de instalar o portal. É possível instalar o Postgres como parte de instalar o Edge ou instalar o Postgres autônomo para uso no portal.
- Se você instalar o Postgres de forma independente, ele poderá estar no mesmo nó que o portal.
- Se você estiver se conectando ao Postgres instalado como parte do Edge e o Postgres estiver configurado no modo mestre/de espera, especifique o endereço IP do servidor mestre do Postgres.
Você está executando a instalação na versão de 64 bits de uma versão com suporte do Red Hat Enterprise Linux, CentOS ou Oracle. Consulte a lista de versões compatíveis em Software e versões compatíveis.
O Yum está instalado.

O instalador inclui apenas módulos fornecidos pelo Drupal que sejam exigidos pelo o portal Apigee Developer Services (ou simplesmente o portal). Para informações sobre como instalar outros módulos de contribuição, consulte Extensão do Drupal 7.

Visão geral da instalação

Depois de instalar o utilitário Edge apigee-setup em um nó, use esse para instalar o portal no nó. O utilitário apigee-setup tem o seguinte formato:

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

Transmita um arquivo de configuração para o utilitário apigee-setup que contém a sobre a instalação. Se o arquivo de configuração estiver sem configurações as informações, o apigee-setup solicita que você o digite na linha de comando.

A única exigência é que o arquivo de configuração possa ser acessado ou lido por "apigee" usuário.

Por exemplo, use o seguinte comando para instalar o portal:

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

Consulte Instalar o utilitário de configuração da Apigee Apigee. para saber mais.

Descontinuação da propriedade SMTPSSL

Nas versões anteriores, você usou a propriedade SMTPSSL para definir o protocolo usado pelo servidor SMTP conectado ao portal. Essa propriedade foi descontinuada.

Agora você usa a propriedade SMTP_PROTOCOL, em vez da propriedade SMTPSSL, para definir o protocolo usado pelo servidor SMTP conectado ao portal. Os valores válidos são: "padrão", "ssl" ou "tls".

Como criar um arquivo de configuração

Veja abaixo um exemplo de arquivo de configuração silenciosa para uma instalação do portal. Editar este arquivo conforme necessário para sua configuração. Use a opção -f para setup.sh para incluir isso .

Observação:não defina o DEVPORTAL_ADMIN_USERNAME=admin. A admin conta de usuário é criada por padrão. Se especificado, uma mensagem de erro é retornada solicitando que você configure um nome de usuário diferente.

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. Testar sua conexão com o Apigee Edge

Execute o comando cURL a seguir para testar sua conexão com o Servidor de gerenciamento de borda. em um prompt de comando no servidor do portal:

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

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

Em que EMAIL e PASSWORD são o e-mail endereço de e-mail e senha do administrador para ORGNAME.

Não se esqueça de especificar o nome do host e o número da porta específicos para a instalação do Edge. Porta 8080 é a porta padrão usada pelo Edge. Se você estiver se conectando a uma organização na nuvem, o URL da solicitação será: https://api.enterprise.apigee.com/v1/organizations/ORGNAME.

Se for bem-sucedido, este comando retornará uma resposta semelhante à seguinte:

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

2. Remover versões do PHP anteriores à 7.0

O script de instalação verifica se há versões do PHP anteriores à 7.0 no sistema antes de iniciar a e instalação. Se houver versões anteriores à 7.0 do PHP, a seguinte mensagem de aviso será exibida:

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

Remova os pacotes PHP usando o seguinte comando:

yum remove package-name

3. Instalar o Postgres

Para instalar o portal, é necessário ter o Postgres instalado. Você pode: instalar o Postgres como parte da instalação do Edge ou instalar o Postgres autônomo para uso no portal do Google Cloud.

Se você estiver se conectando ao Postgres instalado como parte do Edge e ele estiver configurado em modo mestre/em espera, especifique o endereço IP do servidor Postgres mestre.
Se você instalar o Postgres de forma independente, ele poderá estar no mesmo nó que o portal.

Para informações sobre como instalar o Postgres como parte da instalação do Edge, consulte Instalar os componentes do Edge em um nó.

Para instalar o Postgres separadamente:

Instale o utilitário Edge apigee-setup no nó usando a procedimento na Internet ou fora dela. Consulte Instale o utilitário de configuração da Apigee Apigee para mais informações.

Crie um arquivo de configuração para o Postgres, conforme mostrado abaixo:

# 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

No prompt de comando, execute o script de configuração para instalar o Postgres:
```
/opt/apigee/apigee-setup/bin/setup.sh -p pdb -f configFile
```
A opção -p pdb especifica a instalação do Postgre. O arquivo de configuração precisa ser acessíveis ou legíveis para o ambiente usuário.

4. Instalar o portal

Para instalar o portal, siga estas etapas:

Instale o utilitário Edge apigee-setup em o nó usando o procedimento de Internet ou não. Consulte Instalar o utilitário de configuração da Apigee Apigee para mais.
Verifique se você instalou o Postgres, independente ou como parte do instalar o Edge.
No prompt de comando, execute o script de configuração:
```
/opt/apigee/apigee-setup/bin/setup.sh -p dp -f configFile
```
A opção -p dp especifica a instalação do portal.
O arquivo de configuração precisa ser acessível ou legível para a "apigee" usuário.
Navegue até a página inicial do portal em http://localhost:8079 ou até o nome do DNS de seu portal.
Faça login no portal usando as credenciais de administrador definidas no arquivo de configuração para para garantir que o portal esteja funcionando corretamente.
Selecione Relatórios > "Status Report" no menu Drupal para garantir para conferir o status atual do portal.

5. Verifique se o módulo Gerenciador de atualizações está ativada

Para receber notificações de atualizações do Drupal, verifique se o módulo do gerenciador de atualizações do Drupal está ativado. No menu Drupal, selecione Modules e role para baixo até a Atualizar gerenciador. Se não estiver, ative-a.

Depois de ativados, é possível ver as atualizações disponíveis usando o menu Relatórios > Disponível Atualizações. Também é possível usar o seguinte comando Drush:

drush pm-info update

Você precisa executar esse comando no diretório raiz do site. Por padrão, o Desenvolvedor O Portal está instalado em /opt/apigee/apigee-drupal/wwwroot. Portanto, mude o diretório para /opt/apigee/apigee-drupal/wwwroot antes ao executar o comando. Se você não tiver instalado o portal no diretório padrão, mude para seu de instalação do aplicativo.

Use o menu Relatórios > Atualizações disponíveis > Configurações do item de menu a ser configurado módulo para enviar um e-mail a você quando as atualizações estiverem disponíveis e para definir a frequência de verificação atualizações.

6. Configurar o mecanismo de pesquisa Apache Solr (Opcional)

Por padrão, os módulos Drupal que se conectam ao mecanismo de pesquisa Apache Solr são desativados quando você instala o portal. A maioria dos portais usa o mecanismo de busca interno Drupal e, portanto, não exigem os módulos Drupal Solr.

Se você decidir usar o Solr como seu mecanismo de pesquisa, instale o Solr localmente no seu servidor ativar e configurar os módulos Drupal Solr no portal.

Para ativar os módulos Drupal Solr:

Faça login no seu portal como usuário com privilégios de administrador ou de criação de conteúdo.
Selecione Modules no menu Drupal.
Ative o módulo Apache Solr Framework e o Apache Solr Search.
Salve as alterações.
Configure o Solr conforme descrito em https://drupal.org/node/1999280.

7. Instalar o SmartDocs (opcional)

O SmartDocs permite documentar suas APIs no portal de serviços para desenvolvedores de maneira a tornar Documentação da API totalmente interativa. No entanto, para usar o SmartDocs com o portal, primeiro você precisa instalar o SmartDocs no Edge.

Se você estiver conectando o portal a uma instalação do Edge Cloud, o SmartDocs já estará instalado e nenhuma outra configuração é necessária.
Se você estiver conectando o portal a um Edge para instalação de nuvem privada, será preciso que o SmartDocs esteja instalado no Edge. Para saber mais sobre a instalação do Edge e do SmartDocs, consulte Instale o SmartDocs.

Você também precisa ativar os SmartDocs no portal. Para mais informações sobre o SmartDocs, consulte Como usar o SmartDocs para documentar APIs do Google.

8. Configure o Módulo de atualização do JQuery para instalações não relacionadas à Internet (opcional)

Se você instalar e usar o módulo JQuery Update em uma instalação que não seja via Internet, será necessário configurar o módulo para usar a versão local do JQuery. Se você configurar o módulo para usar uma CDN para uma instalação que não seja de Internet, ele tentará acessar a CDN e causará atrasos na página carregando. Para mais informações sobre o módulo de atualização do JQuery, consulte https://www.drupal.org/project/jquery_update.

Para configurar o módulo de atualização do JQuery para usar a versão local do JQuery:

Faça login no seu portal como usuário com privilégios de administrador ou de criação de conteúdo.
Selecione Configuração > Desenvolvimento > Atualização do JQuery no menu Drupal.
Clique em Desempenho na navegação à esquerda.
No menu suspenso "CDN da interface do JQuery e JQuery", selecione Nenhum.
Clique em Save configuration.

9. E agora?

As próximas etapas após a instalação do portal de serviços para desenvolvedores são configurar e personalizar de acordo com suas necessidades específicas. A documentação no site da Apigee contém todos os informações sobre como configurar, estilizar e gerenciar um portal. Acesse a documentação em http://apigee.com/docs/developer-services/content/what-developer-portal.

A tabela a seguir lista algumas das tarefas mais comuns que você executa após a instalação, e inclui links para a documentação da Apigee em que você encontra mais informações:

Tarefa	Descrição
Personalizar o tema	O tema define a aparência do portal, incluindo cores, estilo e outros aspectos visuais.
Personalize aparência	A página inicial inclui o menu principal, a mensagem de boas-vindas, o cabeçalho, o rodapé e o título.
Adicionar e gerenciar contas de usuário	O processo de registro controla como novos desenvolvedores registram uma conta no no portal do Google Cloud. Por exemplo, os novos desenvolvedores têm acesso imediato ao portal ou precisam ser verificadas por um administrador. Esse processo também controla como um portal do Google Workspace é notificado quando uma nova conta é criada.
Como configurar e-mail	O portal envia e-mails em resposta a determinados eventos. Por exemplo, quando um novo um desenvolvedor se registrar no portal e perder a senha.
Adicionar e gerenciar contas de usuário	Adicione termos e Página "Condições" que os desenvolvedores precisam aceitar antes de poderem fazer isso acessar o portal.
Adicionar e gerenciar contas de usuário	O portal implementa um modelo de autorização com base em papéis. Antes de permitir que os desenvolvedores se registrar, definir as permissões e funções usadas pelo portal.
Adicionar blog e postagens de fórum	O portal tem suporte integrado para blogs e fóruns com conversas agrupadas. Definir as permissões para visualizar, adicionar, editar e excluir postagens de blogs e fóruns.
Verifique se você está fazendo backups do banco de dados	Verifique se você está fazendo backup do banco de dados Drupal. Observe que, como cada é diferente, cabe a você determinar a melhor forma de fazer backup no seu banco de dados. Observação: o módulo de backup e migração não é compatível com o Postgres. bancos de dados. Consulte também Como fazer um backup.
Configurar um nome do host	Se você não configurar um nome de host em seu servidor DNS, sempre poderá acessar o site via o endereço IP do servidor. Se quiser usar um nome de host, configure o DNS para servidor, que deve funcionar corretamente sem qualquer outra configuração em uma configuração básica. Se você configurou um balanceador de carga ou está recebendo URLs incorretos no site por alguns outro motivo, você pode definir `$base_url` para Drupal seguindo estas etapas: Crie o diretório `/opt/apigee/data/apigee-drupal-devportal/sites/default/includes` caso ele não exista. Crie um arquivo chamado `settings.php` nesse diretório. Adicione o código abaixo ao arquivo `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’; Mude a última linha `$base_url` para o nome do host do site. Salve o arquivo. É possível colocar outras configurações de `/opt/apigee/data/apigee-drupal-devportal/ sites/default/default.settings.php` nesse arquivo. Para mais informações sobre a propriedade `$base_url`, consulte: https://codeburst.io/security-for-drupal-and-related-server-software-3c979b041595 https://www.drupal.org/node/1992030
Desenvolvimento personalizado	Você também pode ampliar os recursos do seu portal com código personalizado tema. Para fazer isso, crie seu próprio módulo do Drupal conforme descrito no módulo desenvolvimento e coloque o módulo no `/sites/all/modules` diretório.