Edge para nuvem privada v. 4.17.01
Use o comando setup-org para realizar o processo de integração. Execute o comando no nó do servidor de gerenciamento.
Como parte do processo de integração, o script:
- Cria a organização.
- Define o usuário especificado como administrador da organização.
- Esse usuário precisa ser diferente do usuário administrador do sistema. Ou seja, não use o usuário administrador do sistema como um admin. da organização.
- É possível especificar um usuário atual para o administrador da organização ou configurar o script para criar um novo usuário.
- Associa a organização a um pod. Por padrão, ela é associada ao pod "gateway".
- Crie um ambiente.
- Crie um host virtual para o ambiente.
- Associe o ambiente a todos os processadores de mensagens.
- Ativa as análises.
Arquivo de configuração para integração
Transmita um arquivo de configuração para o comando setup-org. Invoque o comando setup-org e especifique a opção -f, incluindo o caminho para o arquivo de configuração silenciosa:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
O único requisito para instalações silenciosas é que o arquivo de configuração precisa ser acessível ou legível pelo usuário "apigee".
Veja abaixo um exemplo de arquivo de configuração silenciosa. Edite-o conforme necessário para seus requisitos:
IP1=192.168.1.1 # Specify the IP or DNS name of the Management Server. MSIP="$IP1" # Specify the Edge sys admin credentials. ADMIN_EMAIL="admin@email.com" APIGEE_ADMINPW=adminPassword # If omitted, you are prompted for it. # Specify organization name. ORG_NAME=myorg # lowercase only, no spaces, underscores, or periods. # Specify the organization administrator user. # Either specify an existing user, or specify the information # necessary to create a new user. # Do not use the sys admin as the organization administrator. # # Create a new user for the organization administrator. NEW_USER="y" # New user information if NEW_USER="y". USER_NAME=new@user.com FIRST_NAME=new LAST_NAME=user USER_PWD="newUserPword" ORG_ADMIN=new@user.com # # Or, specify an existing user as the organization admin, # omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD. # NEW_USER="n" # ORG_ADMIN=existing@user.com # Specify environment name. ENV_NAME=prod # Specify virtual host information. VHOST_PORT=9001 VHOST_NAME=default # If you have a DNS entry for the virtual host. VHOST_ALIAS=myorg-test.apigee.net # If you do not have a DNS entry for the virtual host, # specify the IP and port of each router as a space-separated list: # VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001" # Optionally configure TLS/SSL for virtual host. # VHOST_SSL=y # Set to "y" to enable TLS/SSL on the virtual host. # KEYSTORE_JAR= # JAR file containing the cert and private key. # KEYSTORE_NAME= # Name of the keystore. # KEYSTORE_ALIAS= # The key alias. # KEY_PASSWORD= # The key password, if it has one. # Specify the analytics group. # AXGROUP=axgroup-001 # Default name is axgroup-001.
Observações:
- Em VHOST_ALIAS, se você
já tiver um registro DNS que será usado para acessar o host virtual, especifique o alias do host
e, opcionalmente, a porta, por exemplo, "myapi.example.com". Se você ainda não
tiver um registro DNS, use o endereço IP do roteador.
Para mais informações sobre como configurar o host virtual, consulte Requisitos de instalação da demonstração do Edge. - Para a configuração de TLS/SSL, consulte Keystores e Truststores e Como configurar o acesso TLS a uma API para a nuvem privada para mais informações sobre como criar o arquivo JAR e outros aspectos da configuração de TLS/SSL.
Procedimento de integração
- Instale apigee-provision no
nó do servidor de gerenciamento:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision install - Execute o comando no nó do servidor de gerenciamento:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
O arquivo de configuração precisa ser acessível ou legível pelo usuário "apigee".
Verificação de integração
Após a conclusão da integração, verifique o status do sistema emitindo os seguintes comandos CURL no nó do servidor de gerenciamento.
- Verifique o status do usuário e da organização no servidor de gerenciamento emitindo os seguintes
comandos CURL:
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/users
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/deployments - Se você ativou a análise, use este comando:
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provisioning/axstatus - Também é possível verificar o status do banco de dados do PostgreSQL executando o seguinte comando na
Máquina 2 para iniciar o psql:
> psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
No prompt de comando, digite o seguinte comando para visualizar a tabela de análise da sua organização:
apigee=# : \d analytics."<orgname>.prod.fact"
Use o seguinte comando para sair do psql:
apigee=# \q - Acesse a interface do usuário da Apigee Edge usando um navegador da Web. Lembre-se de que você já anotou
o URL do console de gerenciamento no final da instalação.
- Inicie o navegador de sua preferência e insira o URL da interface do Edge. Ele é semelhante ao
seguinte, em que o endereço IP é da Máquina 1 ou de qualquer máquina em que você instalou
a IU para configurações alternativas:
http://192.168.56.111:9000/login
9000 é o número da porta usado pela IU. Se você estiver iniciando o navegador diretamente no servidor que hospeda a IU do Edge, use um URL no formato:
http://localhost:9000/login
Observação: verifique se a porta 9000 está aberta. - Na página de login do console, especifique o nome de usuário/senha do administrador do sistema da Apigee.
Observação: essa é a senha global do administrador do sistema que você definiu durante a instalação. Você também pode:
- Inicie o navegador de sua preferência e insira o URL da interface do Edge. Ele é semelhante ao
seguinte, em que o endereço IP é da Máquina 1 ou de qualquer máquina em que você instalou
a IU para configurações alternativas:
- Crie uma nova conta de usuário da Apigee e use a nova credencial para fazer login.
- Clique em "Fazer login". O navegador redireciona para:
http://192.168.56.111:9000/platform/#/<orgname>/
e abre um painel que permite configurar a organização criada antes (se conectado usando as credenciais de administrador da Apigee). - Se você não conhece o Edge, agora pode criar seu primeiro proxy de API. Para mais informações,
consulte Criar seu primeiro proxy de API.
Consulte também as seções sobre amostras, incluindo a Lista de amostras, e as APIs RESTful de destino simulado que podem ser usadas nos seus próprios experimentos de criação de APIs em API Mock Target.
- Clique em "Fazer login". O navegador redireciona para: