Instalación de una pasarela API remota DataPower

Editar en línea

Ahora puede desplegar un DataPower® API Gateway remoto en su propio entorno desde su instancia API Connect en webMethods Hybrid Integration El despliegue de una DataPower API Gateway remota ofrece todas las ventajas de registrar una DataPower API Gateway remota, como flujos de datos controlados, conexiones de servicio seguras y fiables y compatibilidad con la privacidad de los datos. También añade una guía sencilla, paso a paso, para desplegar un nuevo DataPower API Gateway en su entorno.

Antes de empezar

Nota: Actualmente, esta función sólo es compatible con DataPower API Gateway y sólo se admite en los clústeres de Red Hat OpenShift.
Nota: Esta función requiere una suscripción Premium en la instancia API Connect en webMethods Hybrid Integration

Para completar el procedimiento de despliegue descrito en esta tarea, debe ser el propietario de la organización proveedora o tener asignada una función que tenga el rolSettings:Managepermiso.

Acerca de esta tarea

Esta tarea explica cómo desplegar un DataPower API Gateway remoto en su propio entorno.

Procedimiento

  1. Despliega un DataPower API Gateway remoto de la siguiente manera.
    Nota: El procedimiento de despliegue que aquí se explica registra automáticamente la dirección remota DataPower API Gateway en API Connect.
    1. Inicie sesión en API Connect.
    2. En el banner de la página, haz clic en icono de configuración de instancia.
    3. En la página de configuración de la instancia, vaya a Puerta de enlace remota y haga clic en Añadir +.
    4. Haga clic en Desplegar y, a continuación, en Siguiente.
    5. Introduzca el título, el espacio de nombres, URL del punto de conexión de administración y la URL base del punto de conexión de invocación de la API.
      Nota: Las entradas de punto final deben referirse a direcciones que estén correctamente configuradas para su uso posterior por la pasarela.
    6. Pulse Siguiente.
    7. Desde la sección de manifiesto de operadores en la página Implementar operadores, guarde el manifiesto en un archivo.
    8. Inicie sesión en su clúster Red Hat OpenShift desde CLI y ejecute el siguiente comando.
      Nota: Sustituya ${OPERATORS_MANIFEST_FILE} por el nombre del archivo de manifiesto.
      oc create --filename=${OPERATORS_MANIFEST_FILE}
      Nota: Una vez ejecutado el comando, el clúster tardará aproximadamente un minuto en instalar la dirección CustomResourceDefinitions necesaria.
    9. Verifique la instalación ejecutando el siguiente comando.
      oc get crd | grep -E 'NAME|cert-manager.io|ibm.com'
      El resultado esperado es el siguiente.
      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
    10. Una vez desplegados los operadores necesarios, haga clic en Siguiente.
    11. Desde la sección "Manifiesto de recursos" en la página "Implementar recursos", guarde el manifiesto en un archivo.
    12. Inicie sesión en su clúster Red Hat OpenShift desde CLI y ejecute el siguiente comando.
      Nota: Sustituya ${RESOURCES_MANIFEST_FILE} por el nombre del archivo de manifiesto.
      oc create --filename=${RESOURCES_MANIFEST_FILE}
      Nota: Una vez ejecutado el comando, DataPower API Gateway y sus recursos de apoyo tardarán unos diez minutos en desplegarse, dependiendo de su entorno.
    13. Ejecute el siguiente comando para verificar el progreso del despliegue.
      oc get gatewayclusters --namespace=${NAMESPACE}
      El resultado esperado es el siguiente.
      NAME                READY  STATUS   VERSION    RECONCILED VERSION  AGE
tmd-remote-gateway  3/3    Running  10.0.10.0  10.0.10.0-10278     11m
    14. Ejecute el siguiente comando para verificar el progreso del trabajo de registro, que es responsable de registrar el DataPower API Gateway en API Connect.
      oc get jobs --namespace=${NAMESPACE}
      El resultado esperado es el siguiente.
      
NAME                             STATUS    COMPLETIONS  DURATION  AGE
remote-gateway-registration-job  Complete  1/1          10m       11m
    15. La implantación se realiza correctamente cuando el estado de GatewayCluster es Running y el estado del trabajo es Complete.
    16. Pulse Finalizar.
    17. Asegúrese de que el DataPower API Gateway remoto recién desplegado aparece en la tabla de la pestaña Gateways de la página Instance Settings.
  2. Desregistre un DataPower API Gateway remoto de la siguiente manera.
    Nota: Asegúrese de que todas las referencias a esta pasarela se eliminan de los catálogos, espacios y productos para dar de baja la pasarela.
    1. Inicie sesión en API Connect.
    2. En el banner de la página, haz clic en icono de configuración de instancia.
    3. Navegue hasta la tabla que enumera todas las puertas de enlace en la pestaña Puertas de enlace de la página Configuración de la instancia.
    4. Haga clic en el icono de la papelera situado junto a la pasarela que desea dar de baja.
    5. Introduzca el nombre de la puerta de enlace en la nueva ventana emergente y haga clic en Eliminar.
      Nota: La anulación del registro de DataPower API Gateway remoto no afecta a los recursos que se están ejecutando en su clúster.
    6. Para eliminar por completo DataPower API Gateway y sus recursos de apoyo de su clúster, ejecute el siguiente 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