Agora você pode implementar um DataPower® API
Gateway remoto em seu próprio ambiente a partir de sua instância API Connect em webMethods Hybrid Integration A implantação de um DataPower API
Gateway remoto oferece todos os benefícios do registro de um DataPower API
Gateway remoto, como fluxos de dados controlados, conexões de serviço seguras e confiáveis e suporte à privacidade dos dados. Ele também adiciona um guia simples, passo a passo, para implementar um novo DataPower API
Gateway em seu ambiente.
Antes de Iniciar
Observação: atualmente, esse recurso é compatível apenas com o site DataPower API
Gateway e somente com os clusters Red Hat OpenShift.
Observação: esse recurso requer uma assinatura Premium na instância API Connect em webMethods Hybrid Integration
Para concluir o procedimento de implementação descrito nesta tarefa, você deve ser o proprietário da organização do provedor ou receber a atribuição de uma função que tenha a funçãoSettings:Managepermissão.
Sobre essa tarefa
Esta tarefa explica como implementar um DataPower API
Gateway remoto em seu próprio ambiente.
Procedimento
- Implemente um DataPower API
Gateway remoto da seguinte forma.
Observação: O procedimento de implementação explicado aqui registra automaticamente o site DataPower API
Gateway remoto em API Connect.
- Faça login em API Connect.
- No banner da página, clique em
.
- Na página de configurações da instância, navegue até Remote gateway e clique em Add +.
- Clique em Deploy e depois em Next.
- Digite o título, o namespace, URL do ponto de extremidade de gerenciamento e a base URL do ponto de extremidade de invocação da API.
Observação: as entradas de ponto de extremidade devem se referir a endereços configurados corretamente para uso posterior pelo gateway.
- Clique em Avançar.
- Na seção de manifesto dos operadores na página Deploy operators, salve o manifesto em um arquivo.
- Faça login no cluster Red Hat OpenShift a partir da CLI e execute o seguinte comando.
Observação: Substitua ${OPERATORS_MANIFEST_FILE} pelo nome do arquivo de manifesto.
oc create --filename=${OPERATORS_MANIFEST_FILE}
Observação: depois que o comando é executado, leva cerca de um minuto para que o CustomResourceDefinitions necessário seja instalado em seu cluster.
- Verifique a instalação executando o seguinte comando.
oc get crd | grep -E 'NAME|cert-manager.io|ibm.com'
O resultado esperado é o seguinte.
analyticsbackups.analytics.apiconnect.ibm.com
analyticsclusters.analytics.apiconnect.ibm.com
analyticsrestores.analytics.apiconnect.ibm.com
apiconnectclusters.apiconnect.ibm.com
certificaterequests.cert-manager.io
certificates.cert-manager.io
challenges.acme.cert-manager.io
clusterissuers.cert-manager.io
commonservices.operator.ibm.com
datapowermonitors.datapower.ibm.com
datapowermustgathermanagers.datapower.ibm.com
datapowermustgathers.datapower.ibm.com
datapowerrollouts.datapower.ibm.com
datapowerservicebindings.datapower.ibm.com
datapowerservices.datapower.ibm.com
gatewayclusters.gateway.apiconnect.ibm.com
issuers.cert-manager.io
managementclusters.management.apiconnect.ibm.com
managementdbupgrades.management.apiconnect.ibm.com
managementrestores.management.apiconnect.ibm.com
managementsecretrotations.management.apiconnect.ibm.com
operandbindinfos.operator.ibm.com
operandconfigs.operator.ibm.com
operandregistries.operator.ibm.com
operandrequests.operator.ibm.com
operatorconfigs.operator.ibm.com
orders.acme.cert-manager.io
portalbackups.portal.apiconnect.ibm.com
portalclusters.portal.apiconnect.ibm.com
portalrestores.portal.apiconnect.ibm.com
portalsecretrotations.portal.apiconnect.ibm.com
- Depois que os operadores necessários tiverem sido implantados, clique em Next.
- Na seção Manifesto de recursos da página Implantar recursos, salve o manifesto em um arquivo.
- Faça login no cluster Red Hat OpenShift a partir da CLI e execute o seguinte comando.
Observação: Substitua ${RESOURCES_MANIFEST_FILE} pelo nome do arquivo de manifesto.
oc create --filename=${RESOURCES_MANIFEST_FILE}
Observação: depois que o comando é executado, leva cerca de dez minutos para que o site DataPower API
Gateway e seus recursos de suporte sejam implantados, dependendo do seu ambiente.
- Execute o seguinte comando para verificar o andamento da implementação.
oc get gatewayclusters --namespace=${NAMESPACE}
O resultado esperado é o seguinte.
NAME READY STATUS VERSION RECONCILED VERSION AGE
tmd-remote-gateway 3/3 Running 10.0.10.0 10.0.10.0-10278 11m
- Execute o seguinte comando para verificar o andamento do trabalho de registro, que é responsável por registrar o DataPower API
Gateway em API Connect.
oc get jobs --namespace=${NAMESPACE}
O resultado esperado é o seguinte.
NAME STATUS COMPLETIONS DURATION AGE
remote-gateway-registration-job Complete 1/1 10m 11m
- A implementação é bem-sucedida quando o status de
GatewayCluster é Running e o status do trabalho é Complete.
- Clique em
Concluir.
- Certifique-se de que o DataPower API
Gateway remoto recém-implantado esteja listado na tabela da guia Gateways na página Configurações da instância.
- Desfaça o registro de um DataPower API
Gateway remoto da seguinte forma.
Observação: Certifique-se de que todas as referências a esse gateway sejam removidas dos catálogos, espaços e produtos para cancelar o registro do gateway.
- Faça login em API Connect.
- No banner da página, clique em .
- Navegue até a tabela que lista todos os gateways na guia Gateways da página Configurações da instância.
- Clique no ícone da lixeira ao lado do gateway a ser cancelado.
- Digite o nome do gateway na nova janela pop-up e clique em Remove (Remover ).
Observação: o cancelamento do registro do site DataPower API
Gateway remoto não afeta os recursos que estão em execução no cluster.
- Para remover completamente o site DataPower API
Gateway e seus recursos de suporte do cluster, execute o seguinte comando.
oc delete --filename=${RESOURCES_MANIFEST_FILE}
oc delete --filename=${OPERATORS_MANIFEST_FILE}
for CRD in $(oc get crd | grep 'cert-manager.io|ibm.com' | awk '{print $1}'); do oc delete crd $CRD; done