Edge para nuvem privada v. 4.17.05
Use o comando setup-org para executar 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 o 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 administrador da organização.
- Especifique um usuário atual para o administrador da organização ou configure o script para criar um novo usuário.
- Associa a organização a um pod. Por padrão, é associado ao pod "gateway".
- Crie um ambiente.
- Crie um host virtual para o ambiente.
- Associe o ambiente a todos os processadores de mensagens.
- Possibilita 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 silencioso:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
O único requisito em instalações silenciosas é que o arquivo de configuração precisa estar acessível ou legível pelo usuário "apigee".
Veja abaixo um exemplo de arquivo de configuração silenciosa. Edite 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:
- Para VHOST_ALIAS, se você já tiver um registro DNS que será usado para acessar o host virtual, especifique o alias do host e, se quiser, a porta, por exemplo, "myapi.example.com". Se 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 Como configurar um host virtual. - Para a configuração 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.
- Para mais informações sobre como configurar hosts virtuais, consulte Como configurar o acesso TLS a uma API para a nuvem privada.
Procedimento de integração
- Instale o 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 estar 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/organizationEmails/deployment10 > curlvorg/deployment1>: - Se você ativou o Analytics, use este comando:
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/atuais/axstatus - Também é possível verificar o status do banco de dados PostgreSQL executando o seguinte comando na Máquina 2 para iniciar o HBase:
>Apigee -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 organização:
apigee=# : \d prod. - Acesse a interface do usuário do 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 seu navegador e insira o URL da interface do Edge. Ele é semelhante ao exemplo a seguir, em que o endereço IP é da Máquina 1 ou da 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 interface 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 Apigee.
Observação: essa é a senha de administrador global do sistema que você definiu durante a instalação. Você também pode fazer o seguinte:
- Inicie seu navegador e insira o URL da interface do Edge. Ele é semelhante ao exemplo a seguir, em que o endereço IP é da Máquina 1 ou da máquina em que você instalou a IU para configurações alternativas:
- Inscreva-se em uma nova conta de usuário da Apigee e use a nova credencial de usuário 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 anteriormente, se tiver feito login usando as credenciais de administrador da Apigee. - Se você nunca usou o Edge, poderá criar seu primeiro proxy de API. Para saber mais,
consulte Criar seu primeiro proxy de API.
Consulte também as seções sobre amostras, incluindo a Lista de amostras e as APIs RESTful simuladas que você pode usar nos seus próprios experimentos de criação de APIs na API Mock Target.
- Clique em "Fazer login", o navegador redireciona para: