Requisitos do portal de serviços para desenvolvedores

Portal de serviços para desenvolvedores v. 4.16.09

Confira a seguir os requisitos de hardware e software para a instalação.

Hardware

Requisito

Sistema operacional

Estas instruções de instalação e os arquivos de instalação fornecidos foram testados nos sistemas operacionais listados aqui: https://apigee.com/docs/api-services/reference/supported-software

RAM

1 GB

Disco rígido

10 GB

Interface de rede

É necessária uma conexão de Internet ativa.

Como parte do processo de instalação, o instalador faz o download de recursos da Web. Se o ambiente estiver configurado para fazer proxy de solicitações HTTP e HTTPS de saída, o proxy precisará ser configurado para processar corretamente as solicitações redirecionadas que podem ocorrer durante um download.

Por exemplo, uma solicitação para https://drupal.org/ retorna um código de status HTTP 301 e redireciona para https://www.drupal.org/.

O proxy precisa ser configurado para retornar um código de status HTTP 200 com o conteúdo solicitado do redirecionamento.

Para instalações do SAP, se o ambiente estiver configurado para encaminhar solicitações HTTPS de saída, o proxy precisará ser compatível com TLSv1.0. O OpenSSL 0.9.8 não oferece suporte a TLSv1.1 ou TLSv1.2, apenas a TLSv1.0.

Requisitos do banco de dados MySQL

Se você optar por instalar o MySQL Server na mesma máquina que o Developer Channel Services, a topologia de máquina única, o instalador do Developer Channel Services vai solicitar que você insira o nome e o usuário do banco de dados, além de instalar o MySQL Server e criar o esquema do banco de dados para você. A versão instalada é a mais recente disponível para seu SO.

Se você quiser instalar o MySQL Server em um sistema separado, ele já precisa estar instalado nesse sistema antes de iniciar o instalador do Developer Channel Services. É necessário ter o MySQL 5.0.15 ou mais recente instalado.

O instalador dos serviços do canal de desenvolvedor exige que o servidor MySQL contenha um banco de dados com um esquema vazio. O instalador do Developer Channel Services solicita o nome do host, o nome e o usuário do banco de dados. O instalador então se conecta ao banco de dados para criar as tabelas e os dados padrão do banco de dados.

O usuário do banco de dados é usado pelo Developer Channel Services para se conectar ao banco de dados e precisa ter os seguintes privilégios: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES.

Por exemplo, para criar um banco de dados chamado devportal e um usuário chamado devportal:

  1. Instalar o MySQL Server no sistema.
  2. Faça login no MySQL como usuário raiz usando o comando:
    > mysql -u root -p
  3. Digite a senha raiz quando solicitado.
  4. No prompt mysql>, insira o seguinte para criar o usuário devportal:
    mysql>create user 'devportal'@'localhost' identified by 'devportal';
    mysql> grant all privileges on *.* to 'devportal'@'localhost';
    mysql> flush privileges;
    mysql> quit
  5. Na solicitação do sistema, crie o banco de dados devportal:
    > mysqladmin -u devportal -p create devportal

    Insira a senha devportal.
  6. Faça login no MySQL e conceda acesso ao devportal pelo IP do servidor do portal:
    mysql> GRANT ALL ON devportal.* TO devportal@'portalIP IDENTIFIED BY 'devportalPW';

    onde portalIP é o endereço IP do servidor do portal e devportalPW é a senha do usuário devportal.
  7. Edite /etc/my.cnf para definir bind-address como o endereço IP do servidor MySQL.
  8. Reinicie o MySQL:
    > /etc/init.d/mysqld restart
  9. Verifique se a porta 3306 está aberta no servidor MySQL. Este procedimento é baseado no seu sistema operacional. Por exemplo, para Linux, use o comando:
    > /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j ACCEPT

Ao instalar os Serviços do Canal para Desenvolvedores, especifique que o servidor MySQL não será instalado localmente. Você vai precisar inserir o endereço IP, o nome de usuário e o nome do banco de dados remoto.

Requisitos do Red Hat Enterprise Linux (RHEL)

O RHEL tem requisitos extras devido a uma assinatura necessária para acessar downloads de software do Red Hat. O servidor precisa se conectar à Internet para fazer o download de RPMs pelo yum. Se você estiver usando o RHEL, o servidor precisa estar registrado na Red Hat Network (RHN) e no canal opcional do servidor.

Os requisitos do Red Hat são verificados durante a instalação, e o instalador do portal solicita se o RHEL ainda não está registrado. Se você já tiver credenciais de login da Red Hat, poderá usar o seguinte comando para registrar o RHEL antes de iniciar o processo de instalação:

> subscription-manager register --username=my_username --password=my_password --auto-attach 

Substitua my_username e my_password pelas suas credenciais do Red Hat.

Se você tiver uma versão de avaliação do RHEL, poderá adquirir uma licença de teste de 30 dias. Consulte https://access.redhat.com/solutions/32790 para mais informações.

Requisitos do SMTP

Por padrão, o portal envia e-mails usando a função PHP mail(). O PHP tenta enviar e-mails usando o sendmail no sistema local, que pode ser configurado no arquivo php.ini do PHP.

Em um ambiente de produção, a Apigee exige que você configure um servidor SMTP para enviar mensagens de e-mail do portal. Portanto, é necessário garantir que o Drupal possa acessar a porta necessária no servidor SMTP. Para SMTP sem TLS, o número da porta geralmente é 25. Para SMTP ativado para TLS, geralmente é 465, mas verifique com seu provedor SMTP.

Requisitos adicionais

Para realizar a instalação, o usuário que instala o software precisa ter acesso raiz.

Requisitos de arquitetura de implantação

Os serviços de canal para desenvolvedores têm uma única interface com o servidor de gerenciamento da Apigee por meio de uma API REST para armazenar e extrair informações sobre os aplicativos de um usuário. Os serviços de canal do desenvolvedor precisam se conectar ao servidor de gerenciamento por HTTP ou HTTPS, dependendo da instalação.

Informações necessárias antes de iniciar a instalação

Antes de iniciar a instalação, você precisa ter as seguintes informações disponíveis:

  1. Qual plataforma você está configurando: Red Hat ou CentOS? Se for uma instalação da Red Hat, a máquina precisará estar registrada na Red Hat Network para fazer o download das RPMs.
  2. Você planeja instalar o MySQL na máquina local? Algumas instalações de HA exigem que o MySQL esteja em uma máquina diferente da que exibe as páginas da Web do portal. Nesse caso, não instale o MySQL localmente. Se você quiser uma instalação simples com tudo na mesma máquina, instale o MySQL localmente.
  3. Se você pretende acessar um servidor MySQL remoto, o nome do host, a porta, o nome do banco de dados, o nome de usuário e a senha do servidor MySQL remoto. O servidor MySQL remoto precisa estar configurado antes de você iniciar a instalação.
  4. Qual é o nome de domínio totalmente qualificado do servidor da Web? Essas informações serão adicionadas a /etc/hosts. Deve ser um endereço IP ou um nome de host, como portalserver.example.com. O valor padrão é localhost.
  5. Você quer usar a configuração padrão da Apigee para o host virtual do Apache? Um host virtual é criado com o nome de host especificado na etapa 7.
  6. Há três informações que permitem que seu portal se comunique com o servidor de gerenciamento do Apigee Edge. Confira as informações a seguir:
    1. URL do endpoint da API de gerenciamento da Apigee: ele será um nome do host ou um endereço IP. Esse é o endpoint REST para o qual todas as chamadas são feitas para criar apps e registrar desenvolvedores para chaves de app. O endpoint padrão é https://api.enterprise.apigee.com/v1.

      Para uma instalação do Edge para nuvem privada, o URL tem o formato:
      http://EdgeIp:8080/v1

      ou:
      https://EdgeIp:SSLport/v1

      Em que EdgeIp é o endereço IP do servidor de gerenciamento do Edge e SSLport é a porta SSL da API de gerenciamento do Edge. Por exemplo, 8443.
    2. Nome da organização da Apigee: há uma relação entre os portais e as organizações do Apigee Edge. Você vai configurar a organização padrão ao configurar o endpoint da API Management. O valor padrão é my-org.
    3. Nome de usuário e senha para o endpoint da API de gerenciamento: as chamadas do portal para o Edge precisam ser realizadas por um administrador da sua organização.

      Esse nome de usuário e senha são para um administrador da sua organização e devem ser usados apenas para se conectar ao Edge pelo portal. Por exemplo, se você especificar as credenciais de um usuário e ele for excluído no Edge, o portal não poderá mais se conectar ao Edge. Portanto, crie um administrador na sua organização apenas para essa conexão.

      Por exemplo:
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd