Para integrar uma organização, você precisa criar e transmitir um arquivo de configuração de integração
ao comando setup-org
. Cada uma dessas etapas é descrita nas seções que
seguir.
Para informações sobre como usar a API de gerenciamento para integrar uma organização, consulte Criar uma organização, e host virtual.
Criar um arquivo de configuração de integração
Esta seção inclui um exemplo de arquivo de configuração para integrar uma organização ao
setup-org
:
Copie o exemplo a seguir e faça as edições necessárias para sua organização:
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=admin_password # 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 # Org admin password must be at least 8 characters long and contain one uppercase # letter, one lowercase letter, and one digit or special character 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 # lowercase only # 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 você usará para acessar o host virtual, especifique o host alias e, opcionalmente, a porta, por exemplo, "myapi.example.com". Se você ainda não tiver um DNS será possível usar o endereço IP do roteador.
Para mais informações sobre como configurar o host virtual, consulte Como configurar configure um host virtual.
- Para configuração TLS/SSL, consulte Keystores e Truststores e Como configurar 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 obter mais informações sobre a configuração de hosts virtuais, consulte Como configurar o acesso TLS a um para a nuvem privada.
- Não é possível criar duas organizações com o mesmo nome. Nesse caso, a segunda criação será falhar.
Executar setup-org
Depois de criar o arquivo de configuração de integração, transmita-o ao setup-org
.
script para executar o processo de integração. Você precisa executar o script no servidor de gerenciamento
nó.
Ao integrar uma organização, o script setup-org
faz o seguinte:
- Cria uma nova organização.
- Cria um ambiente.
- Cria um host virtual para o ambiente.
- Define o usuário especificado como o administrador da organização. Observações:
- Use um usuário atual ou crie um novo para o administrador da organização.
- O administrador da organização não pode ser o mesmo que o administrador de sistema.
- Associa a organização ao "gateway" bando (Este é o padrão e não pode ser changed.)
- Associa o ambiente a todos os processadores de mensagens.
- Permite análises.
Para executar setup-org
:
- Instale
apigee-provision
no nó do servidor de gerenciamento:/opt/apigee/apigee-service/bin/apigee-service apigee-provision install
- Execute o script
setup-org
no nó do servidor de gerenciamento e aponte-o para arquivo de configuração criado em Criar uma configuração de integração arquivo:/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
O arquivo de configuração precisa ser legível para o ambiente do Apigee usuário.
- Verifique se você integrou uma organização com sucesso. Uma maneira de fazer isso é registrar
na interface solicitando o seguinte URL em um navegador:
http://IP_address:9000/login
Em que IP_address é o endereço IP do servidor em que você instalou o Edge. de ML pela IU.
Confira outras etapas de verificação em Verificar a integração.
- Crie seu primeiro proxy.
Verificar a integração
Após a integração, verifique o status do sistema emitindo o seguinte
Comandos curl
no nó do servidor de gerenciamento:
- Verifique o status do usuário e da organização no servidor de gerenciamento executando o seguinte
comandos:
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/org_name/deployments
- Verifique a análise executando o seguinte comando:
curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
- Verifique o status do banco de dados do PostgreSQL executando os seguintes comandos no Nó 2
(conforme mostrado nas topologias de instalação):
psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
No prompt de comando, digite o comando a seguir para ver a tabela de análise da sua organização:
\d analytics."org_name.env_name.fact"
Use o seguinte comando para sair do psql:
\q
- Acesse a IU do Apigee Edge usando um navegador da Web. Lembre-se de que você já anotou
do console de gerenciamento no fim da instalação.
- Abra seu navegador preferido e insira o URL da interface do Edge. Ela é semelhante à
em que o endereço IP é para o Nó 1 (como mostrado no
topologias de instalação) ou
qualquer nó em que você
instalou a IU para configurações alternativas:
http://192.168.56.111:9000/login
9000 é o número da porta usada pela interface.
Se você iniciar o navegador diretamente no servidor que hospeda a interface de usuário do Edge, pode usar um URL no formato:
http://localhost:9000/login
- Na página de login do console, especifique o nome de usuário/senha do administrador do sistema da Apigee.
- Abra seu navegador preferido e insira o URL da interface do Edge. Ela é semelhante à
em que o endereço IP é para o Nó 1 (como mostrado no
topologias de instalação) ou
qualquer nó em que você
instalou a IU para configurações alternativas:
- Crie uma nova conta de usuário da Apigee e faça login com a nova credencial de usuário. No(s) dia(s)
do console do Cloud, clique no botão Fazer login.
O navegador redireciona para
http://192.168.56.111:9000/platform/#/org_name/
e abre um painel que permite configurar a organização que você criou (se você no uso de credenciais de administrador da Apigee).
Criar seu primeiro proxy
Depois de integrar uma nova organização e verificar se o processo de integração foi bem-sucedido, agora você pode criar seu primeiro proxy. Para mais informações, consulte Criar seu primeiro proxy de API.
Outros recursos que podem ser úteis incluem: