Requisitos do portal de serviços para desenvolvedores

Portal de serviços para desenvolvedores v. 4.16.05

Veja a seguir os requisitos de hardware e software para 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ário ter 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 solicitações HTTP e HTTPS de saída de proxy, então 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/.

É necessário configurar o proxy 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 solicitações HTTPS de saída de proxy, o proxy precisará oferecer suporte a TLSv1.0. O OpenSSL 0.9.8 não é compatível com TLSv1.1 ou TLSv1.2, apenas com TLSv1.0.

Requisitos do banco de dados MySQL

Se você optar por instalar o servidor MySQL na mesma máquina que o Developer Channel Services, a topologia de máquina única, o instalador do Developer Channel Services solicitará que você digite o nome do banco de dados e o usuário do banco de dados e, em seguida, 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ê quer que o MySQL Server seja instalado em um sistema separado, é necessário já ter instalado o MySQL Server no sistema antes de iniciar o instalador do Developer Channel Services. É necessário ter instalado o MySQL 5.0.15 ou posterior.

O instalador do Developer Channel Services exige que o MySQL Server 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. Em seguida, o instalador 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 este comando:
    > mysql -u root -p
  3. Digite a senha raiz quando solicitado.
  4. No prompt mysql>, digite o seguinte para criar o usuário do devportal:
    mysql>create user 'devportal'@'localhost' identificado por "devportal';
    mysql> concede todos os privilégios em *.* a "devportal'@'localhost';
    mysql> esvazie os privilégios;
    mysql> quit
  5. No prompt do sistema, crie o banco de dados devportal:
    > mysqladmin -u devportal -p create devportal

    Digite 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';

    em que 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 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 do 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 o Developer Channel Services, especifique para não instalar o MySQL Server localmente. Em seguida, você será solicitado a inserir o endereço IP, o nome de usuário e o nome do banco de dados remoto.

Requisitos do Red Hat Enterprise Linux (Ela )

O AOSP tem requisitos extras devido à necessidade de uma assinatura para acessar os downloads de software da Red Hat. O servidor precisa ser capaz de se conectar à Internet para fazer o download de RPMs com o yum. Se você estiver usando o php, o servidor precisará 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 que você se o AOSP ainda não estiver registrado. Se você já tiver credenciais de login do Red Hat, poderá usar o seguinte comando para registrar o AOSP 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 teste do AOSP, poderá adquirir uma licença de avaliação 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 mail() do PHP. 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 pelo portal. Portanto, você precisa 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 o SMTP com TLS ativado, ele geralmente é 465, mas verifique com o provedor SMTP.

Outros requisitos

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

Requisitos da arquitetura de implantação

O Developer Channel Services tem uma interface única com o servidor de gerenciamento da Apigee por meio de uma API REST para armazenar e recuperar informações sobre os aplicativos de um usuário. O Developer Channel Services terá que se conectar ao servidor de gerenciamento via 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? No caso de uma instalação da Red Hat, a máquina precisa estar registrada na Red Hat Network para fazer o download de RPMs.
  2. Você planeja instalar o MySQL na máquina local? Algumas instalações de alta disponibilidade exigem que o MySQL esteja em uma máquina diferente daquela que veicula 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, informe o nome do host, a porta, o nome do banco de dados, o nome de usuário e a senha desse servidor. O servidor MySQL remoto já deve 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. Precisa ser um endereço IP ou nome do 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 do host que você especificou acima na etapa 7.
  6. Há três informações que permitem que seu portal se comunique com o servidor de gerenciamento do Apigee Edge. Essas informações são as seguintes:
    1. URL do endpoint da API Apigee Management: será um nome do host ou um endereço IP. Esse é o endpoint REST em que todas as chamadas são feitas para criar apps e registrar desenvolvedores para chaves de apps. 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 a porta EdgeIp é o endereço IP do servidor de gerenciamento de borda e SSLport Por exemplo, 8443.
    2. Nome da organização da Apigee: há uma relação entre portais e organizações do Apigee Edge. Você definirá 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 do 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 de um administrador na 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 organização apenas para essa conexão.

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