Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Implementa Edge Microgateway como un proxy de sidecar

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X. info

OBSOLETO: Se admite la ejecución de Edge Microgateway en Kubernetes con el patrón de proxy sidecar. Sin embargo, edgemicroctl y las herramientas relacionadas que se describen en este tema están obsoletos. Esta herramienta se basa en el inyector de sidecar de Istio, que ya no es compatible.

Introducción

En este tema, se explica cómo ejecutar Edge Microgateway en un clúster de Kubernetes como un proxy sidecar. Tienes dos opciones para la implementación de sidecar: inyección manual y automática. En este tema, se describen ambas opciones.

Para obtener más información, consulta Introducción a Edge Microgateway en Kubernetes.

Antes de comenzar

Completa los pasos que se describen en Requisitos previos.

Implementa un servicio de prueba

Implementa un servicio simple de "hello" y verifica la implementación:

Implemente la muestra

kubectl apply -f samples/helloworld/helloworld.yaml --namespace=default

Verifica que el servicio esté en ejecución. Es posible que debas esperar unos minutos hasta que el Pod se inicie y pase al estado de ejecución:
```
kubectl get pods --namespace=default
```
Resultado de ejemplo:
```
NAME                          READY     STATUS    RESTARTS   AGE
helloworld-569d6565f9-lwrrv   1/1       Running   0          17m
```
Nota: Ten en cuenta que el estado READY de 1/1 significa que hay "uno de uno" servicios que se ejecutan en el pod. En los siguientes pasos, configurarás el clúster para que Edge Microgateway se inserte automáticamente como un sidecar en cualquier Pod nuevo que crees. Cuando eso suceda, verás que, cuando ejecutes kubectl get pods, habrá "dos de dos" servicios en ejecución en el pod: el servicio y el sidecar.
Borra la implementación del servicio de prueba. La volverás a instalar más adelante, después de habilitar la inserción de sidecar:
```
 kubectl delete -f samples/helloworld/helloworld.yaml --namespace=default
```

Usa la inserción manual de sidecar

De las dos opciones de inserción de sidecar, la inserción manual es el enfoque más simple y directo, y se puede realizar con un solo comando kubectl.

Configura Edge Microgateway

El siguiente comando configura Edge Microgateway para tu organización de Apigee y, luego, implementa el proxy edgemicro-auth.

Ejecuta el siguiente comando:

edgemicro configure -o [org] -e [env] -u [username]

Donde:

org: Es el nombre de tu organización de Edge (debes ser administrador de la organización).
env: Es un entorno de tu organización (como test o prod).
username: Es la dirección de correo electrónico asociada a tu cuenta de Apigee.

Ejemplo

edgemicro configure -o myorg -e test -u jdoe@example.com

El resultado (se muestra un ejemplo a continuación) se guarda en el archivo:

$HOME/.edgemicro/org_name-env_name-config.yaml

current nodejs version is v6.9.1
current edgemicro version is 2.5.25
password:
file doesn't exist, setting up
Give me a minute or two... this can take a while...
App edgemicro-auth deployed.
checking org for existing KVM
KVM already exists in your org
configuring host edgemicroservices.apigee.net for region us-west1

saving configuration information to: /Users/jdoe/.edgemicro/myorg-test-config.yaml

vault info:
 -----BEGIN CERTIFICATE-----
MIICpDCCAYwCCQCV9eBcO9a5WzANBgkqhkiG9w0BAQsFADAUMRIwEAYDVQQDDAls
b2NhbGhvc3QwHhcNMagwODA5MDAzMDEzWhcNMTgwODEwMDAzMDEzWjAUMRIwEAYD
VQQDDBlsb2NhbGhvc3QwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDh
nAHT7JHX/WvWHRFb8FLm53SPIDld5LyPOUfINdEyhSIEeXoOUKg4EPweJPVSC9Vm
Hw4ZMtEqWJM/XsQWvLe8ylRJa5wgmzmFCqAsuzs9+rmc9KvJqjpOh2uRTUf7KKfT
iXL2UEseprcI5g8zNyqKyEf/ecWIwz3AkkPAZebVTsrdDfIDHvkyhhvlAHZAB9kn
GtqP3N8kOlv4KQto9Gr7GYUGUIDugt7gM1F611+RBS+fYRi32GUAq/UQDkhYL8cp
oIJiF7UYkk2+9t9CdOCDuIUCvJioHJQd0xvDpkC9f6LvwjwnCwku+4F2Q63+av5I
mJoZJQPvW5aP53Qkk+kHAgMBAAEwDKYJKoZIhvcNAQELBQADggEBALyUBolXUFN8
1bf268nR+gS8MOFDTxO1bUz+bKuT/g3K1PuNUJTueT+0L1H2OiZUzazAqwn2sqzN
lQuvLg6LjxjlNkqTJGiJvGDcYVq45dv7UyxAZxhqxTxhlQ+Yu5R9pbQnzujezHpH
6gtCoCkSt/QqiJ3YsmsVu5is+HpIJepMt0CyMh5tK9j87hl46QhHklaVfQ3ycMVm
/wNPR/pjizg1FDUeq4nj/7DBVbMf9net/BDaZLeSW1HJ1vcsCXIcSZfQd4QymGFn
8ADrND7ydVjwO/s23soPDTy0g4yLIZvky2tpT8d7YahNqSv2n7sXsLxruzcyCoQ4
w+e3Z3F7IKI=
-----END CERTIFICATE-----

The following credentials are required to start edge micro
  key: 1a3b2754c7f20614817b86e09895825ecc252d34df6c4be21ae24356f09e6eb4
  secret: 16ad2431de73f07f57a6d44048f08d93b63f783bf1f2ac4221182aa7289c7cef

edgemicro configuration complete!

Incorpora Edge Microgateway como un proxy de sidecar

Para incorporar manualmente Edge Microgateway en un Pod de servicio como un proxy de sidecar, ejecuta este comando:

kubectl apply -f <(edgemicroctl -org=your_org -env=your_env -key=your_key -sec=your_secret -conf=config_file_path -svc=service_deployment_file)

Donde:

your_org: Es la organización de Apigee que especificaste en el comando edgemicro configure.
your_env: Es el entorno que especificaste en el comando edgemicro configure.
your_key: Es la clave que muestra el comando edgemicro configure.
your_secret: Es el secreto que muestra el comando edgemicro configure.
config_file_path: Es la ruta de acceso al archivo de configuración de Edge Micro que se devolvió del comando edgemicro configure.
service_deployment_file: Es la ruta de acceso al archivo de implementación del servicio cuyo Pod recibirá el servicio complementario del proxy de sidecar. Por ejemplo: samples/helloworld/helloworld.yaml.

Por ejemplo:

kubectl apply -f <(edgemicroctl -org=myorg -env=test-key=0e3ecea28a64099410594406b30e54439af5265f8 -sec=e3919250bee37c69cb2e5b41170b488e1c1d -conf=/Users/jdoe/.edgemicro/myorg-test-config.yaml -svc=samples/helloworld/helloworld.yaml)

Prueba la configuración

Verifica las implementaciones del servicio:

kubectl get services -n default

Resultado de ejemplo:

NAME         TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)          AGE
helloworld   NodePort    10.15.254.163   <none>        8081:32401/TCP   56s
kubernetes   ClusterIP   10.15.240.1     <none>        443/TCP          41m

Ahora, ya puedes probar la implementación del sidecar de Edge Microgateway. Consulta Cómo probar el proxy para conocer los pasos detallados.

Usa la inserción automática de sidecar

En los siguientes pasos, configurarás la inserción automática de sidecar para tu clúster de Kubernetes. Esta configuración permite que Edge Microgateway se inserte como un proxy de sidecar en Kubernetes.

Instala el inyector de sidecar

Instala el ConfigMap que habilita la inserción de sidecar de Edge Microgateway:

kubectl apply -f install/kubernetes/edgemicro-sidecar-injector-configmap-release.yaml

Ejecuta la siguiente secuencia de comandos para instalar el servicio de webhook. El servicio de webhook es obligatorio para la inyección automática de sidecar:

Nota: Un servicio de webhook requiere un par de claves o certificado firmado. La siguiente secuencia de comandos genera un par de claves o certificado firmado por la autoridad certificadora (CA) de Kubernetes. El archivo de certificado o clave resultante se almacena como un secreto de Kubernetes para que lo consuma el webhook del inyector de sidecar. La aprobación de la CA de Kubernetes requiere permisos para crear y aprobar la solicitud de firma de certificado (CSR). Consulta también Administra TLS en un clúster y examina la secuencia de comandos install/kubernetes/webhook-create-signed-cert.sh para obtener más información.
```
./install/kubernetes/webhook-create-signed-cert.sh \
    --service edgemicro-sidecar-injector \
    --namespace edgemicro-system \
    --secret sidecar-injector-certs
```

Agrega el paquete de CA al archivo de instalación del webhook. El servidor de la API de Kubernetes usa este archivo para invocar el webhook:

cat install/kubernetes/edgemicro-sidecar-injector.yaml | \
     ./install/kubernetes/webhook-patch-ca-bundle.sh > \
     install/kubernetes/edgemicro-sidecar-injector-with-ca-bundle.yaml

Instala el webhook del inyector de sidecar de Edge Microgateway:

kubectl apply -f install/kubernetes/edgemicro-sidecar-injector-with-ca-bundle.yaml

Resultado de ejemplo:

service "edgemicro-sidecar-injector" created
serviceaccount "edgemicro-sidecar-injector-service-account" created
deployment "edgemicro-sidecar-injector" created
mutatingwebhookconfiguration "edgemicro-sidecar-injector" created

Verifica que el webhook del inyector de sidecar de Edge Microgateway esté en ejecución:

kubectl -n edgemicro-system get deployment -ledgemicro=sidecar-injector

Resultado de ejemplo:

NAME                         DESIRED   CURRENT   UP-TO-DATE   AVAILABLE   AGE
edgemicro-sidecar-injector   1         1         1            1           12m

Verifica que el Pod de inyección de sidecar se esté ejecutando en tu clúster. El espacio de nombres edgemicro-system es donde se instalan los servicios del sistema, incluidos el controlador de Ingress, el backend HTTP predeterminado y el inyector de sidecar:

kubectl get pods -n edgemicro-system

Resultado de ejemplo:

NAME                                            READY     STATUS    RESTARTS   AGE
default-http-backend-55c6c69b88-gfnfd           1/1       Running   0          1h
edgemicro-ingress-controller-64444469bf-jhn8b   1/1       Running   3          1h
edgemicro-sidecar-injector-7d95698fbf-cq84q     1/1       Running   0          3m

Configura e incorpora Edge Microgateway

En el siguiente paso, ejecutarás una secuencia de comandos interactiva para crear una configuración de Edge Microgateway asociada a un espacio de nombres de Kubernetes. Luego, insertarás la configuración en tu clúster de Kubernetes.

Ejecuta la siguiente secuencia de comandos interactiva y proporciona los parámetros solicitados. El comando genera un perfil de configuración que usarás en el siguiente paso.
```
./install/kubernetes/webhook-edgemicro-patch.sh
```
Para obtener información sobre los parámetros de entrada, consulta Referencia.

Ejemplos de entradas:
1. Namespace to deploy application [default]:
  
  Presiona Intro.
2. Authenticate with OAuth Token ("n","Y") [N/y]
  
  Ingresa n.
3. Apigee username [required]:
  
  Ingresa tu nombre de usuario de Apigee (dirección de correo electrónico). Por ejemplo: jdoe@google.com.
4. Apigee password [required]:
  
  Ingresa tu contraseña de Apigee.
5. Apigee organization [required]:
  
  Ingresa el nombre de tu organización de Apigee.
6. Apigee environment [required]:
  
  Ingresa un nombre de entorno para tu organización. Por ejemplo, “prueba”.
7. Virtual Host [default]:
  
  Presiona Intro.
8. Is this Private Cloud ("n","y") [N/y]:
  
  Ingresa n si usas la nube pública.
9. Edgemicro Key. Press Enter to generate:
  
  Presiona Intro.
10. Edgemicro Secret. Press Enter to generate:
  
  Presiona Intro.
11. Edgemicro org-env-config.yaml. Press Enter to generate:
  
  Presiona Intro.
  
  Resultado de ejemplo:
```
current nodejs version is v6.9.1
current edgemicro version is 2.5.25
config initialized to /Users/jdoe/.edgemicro/default.yaml
Configure for Cloud
******************************************************************************************
Config file is Generated in /Users/jdoe/Work/GITHUB/microgateway_2.5.25_Darwin_x86_64/config directory.

Please make changes as desired.
*****************************************************************************************
```
12. Do you agree to proceed("n","y") [N/y]:
  
  Ingresa y.
  
  Resultado de ejemplo:
```
Configuring Microgateway with

key:daacf75dd660d160b801c9117fb1ec0935896615479e39dbbae88be81a2d84
secret:a60fd57c1db9f3a06648173fb541cb9c59188d3b6037a76f490ebf7a6584b0
config:~/.edgemicro/jdoe-test-config.yaml

********************************************************************************************************
kubectl apply -f install/kubernetes/edgemicro-config-namespace-bundle.yaml
********************************************************************************************************
```
Nota: También puedes pasar parámetros a la secuencia de comandos para un uso no interactivo. Consulta los comentarios en ./install/kubernetes/webhook-edgemicro-patch.sh para obtener más detalles.
Ejecuta el comando que se indica en la última línea del resultado. Este comando kubectl incorpora el perfil de configuración de Edge Microgateway generado en Kubernetes:
```
kubectl apply -f install/kubernetes/edgemicro-config-namespace-bundle.yaml
```

Consulta el estado de la inserción del webhook. Ten en cuenta que, actualmente, no está habilitada:

kubectl get namespace -L edgemicro-injection

Resultado de ejemplo:

NAME               STATUS    AGE       EDGEMICRO-INJECTION
default            Active    1d
edgemicro-system   Active    1d
kube-public        Active    1d
kube-system        Active    1d

Ejecuta este comando para habilitar la inserción de webhook para el webhook:
```
kubectl label namespace default edgemicro-injection=enabled
```

Vuelve a consultar el estado de la inserción de webhook. Ten en cuenta que ahora está habilitado:

kubectl get namespace -L edgemicro-injection

Resultado de ejemplo:

NAME               STATUS    AGE       EDGEMICRO-INJECTION
default            Active    1d        enabled
edgemicro-system   Active    1d
kube-public        Active    1d
kube-system        Active    1d

Implementa el servicio de prueba

Ahora, vuelve a implementar el servicio de prueba. Edge Microgateway se insertará automáticamente en el Pod del servicio.

kubectl apply -f samples/helloworld/helloworld.yaml --namespace=default

Confirma que Edge Microgateway se haya incorporado al Pod junto con el servicio de prueba:

kubectl get pods --namespace=default --watch

Resultado de ejemplo:

NAME                          READY     STATUS            RESTARTS   AGE
helloworld-6987878fc4-pkw8h   0/2       PodInitializing   0          12s
helloworld-6987878fc4-pkw8h   2/2       Running           0         26s

Cuando el estado cambie a Running, presiona ctrl-c para salir del comando.

Ahora, ya puedes probar la implementación automática del proxy de sidecar de Edge Microgateway. Consulta Cómo probar el proxy para conocer los pasos detallados.

Prueba el proxy

Con la implementación de sidecar, se crea automáticamente un proxy de API para tu servicio. No es necesario que crees un proxy "adaptado a Edge Microgateway".

Obtén la dirección IP del Ingress

Con la IP externa para Ingress, puedes llamar al servicio desde fuera del clúster.

Obtén la dirección IP externa del controlador de Ingress:

kubectl get ing -o wide

Resultado de ejemplo:

NAME      HOSTS     ADDRESS        PORTS     AGE
gateway   *         35.238.13.54   80        1m

Copia el valor de EXTERNAL-IP para Ingress y expórtalo a una variable. Puedes configurar la variable de forma manual:

export GATEWAY_IP=external_ip

Por ejemplo:

export GATEWAY_IP=35.238.249.62

O bien, usa este comando para configurarlo:

export GATEWAY_IP=$(kubectl describe ing gateway --namespace default | grep "Address" | cut -d ':' -f2 | tr -d "[:space:]")

Verifica que la variable se haya exportado. Por ejemplo:
```
echo $GATEWAY_IP
```
Resultado de ejemplo:
```
35.238.249.62
```
Llama al servicio:
```
curl $GATEWAY_IP
```
Resultado:
```
{"error":"missing_authorization","error_description":"Missing Authorization header"}
```
A continuación, abordarás el error de autorización faltante configurando un producto de API y una app para desarrolladores en Edge para que puedas obtener una clave de API válida. Cuando agregues la clave a un encabezado de autorización para la llamada a la API, la llamada se realizará correctamente y no verás este error.

Crea componentes en Apigee Edge

A continuación, crea un producto de API y una app para desarrolladores en Apigee Edge.

Crea un producto de API

Accede a Apigee Edge.
Selecciona Publicar > Productos de API en el menú de navegación lateral.
Haz clic en +API Product. Aparecerá la página del producto.
Completa la página del producto de la siguiente manera. Para los campos que no se mencionan a continuación, puedes usar los valores predeterminados. No guardes hasta que se te indique.

Nombre hello-world-product

Nombre visible Edge Micro hello product

Entorno test
En la sección Ruta de acceso, haz clic en + Recurso personalizado.
Agrega la ruta de acceso /.
Vuelve a hacer clic en + Recurso personalizado y agrega la ruta de acceso /**.
En la sección API Proxies, haz clic en + API Proxy y agrega edgemicro-auth.
Guarda el producto de API.

Crear una app de desarrollador

Selecciona Apps en el menú de navegación lateral.
Haz clic en + App. Aparecerá la página de detalles de la app para desarrolladores.
Completa la página de Aplicación para desarrolladores de la siguiente manera. No guardes hasta que se te indique.

Nombre hello-world-app

Nombre visible Edge Micro hello app

Desarrollador Selecciona un desarrollador en el menú desplegable.
En la sección Credenciales, haz clic en + Producto y selecciona el hello-world-product que acabas de crear.
Haz clic en Guardar.
Volverás a la página en la que se enumeran todas las apps para desarrolladores.
Selecciona la app que acabas de crear, hello-world-app.
Haz clic en Mostrar junto a Clave de consumidor.
Copia el valor de la clave del consumidor. Este valor es la clave de API que usarás para realizar llamadas seguras a la API del servicio helloworld.
Espera unos minutos. Los cambios que realizaste en Apigee Edge tardan unos minutos en sincronizarse con la instancia de Edge Microgateway implementada en el clúster.

Nota: Edge Microgateway sondea los cambios realizados en Apigee Edge cada 600 segundos (de forma predeterminada) y extrae cualquier cambio de configuración realizado en los proxies, los productos de API y las apps para desarrolladores. Puedes cambiar el valor predeterminado de 600 s si editas el archivo de configuración de Edge Microgateway. Consulta la documentación de Edge Microgateway para obtener más detalles.

Llama a la API

Después de que los cambios de configuración se extraigan al microgateway, puedes realizar las siguientes pruebas.

Llama a la API sin una clave de API. Recibirás un mensaje de error, como se muestra a continuación:
```
curl $GATEWAY_IP
```
Resultado esperado:
```
{"error":"missing_authorization","error_description":"Missing Authorization
header"}
```
Para realizar llamadas a la API correctas, necesitas la clave de API.
Obtén la clave de consumidor de la app para desarrolladores que creaste. Este valor es la clave de API que necesitas para llamar al proxy de prueba:
```
curl -H 'x-api-key:your-edge-api-key'  $GATEWAY_IP
```
Por ejemplo:
```
curl -H "x-api-key:DeX2eEesYAdRJ5Gdbo77nT9uUfJZql19" $GATEWAY_IP
```
Resultado:
```
Hello world
```
El servicio helloworld implementado en el pod devuelve la respuesta "Hello world". La llamada a ese servicio pasó primero por Edge Microgateway, donde se realizó la autenticación. Si ves la respuesta "Hello world", significa que configuraste correctamente Edge Microgateway para que funcione como un proxy sidecar en el Pod del servicio helloworld.

Próximos pasos

Consulta la sección Tareas para obtener información sobre cómo agregar complementos personalizados, escalar la implementación, realizar cambios en la configuración y otras tareas que desees realizar.

Nombre	`hello-world-product`
Nombre visible	`Edge Micro hello product`
Entorno	`test`

Nombre	`hello-world-app`
Nombre visible	`Edge Micro hello app`
Desarrollador	Selecciona un desarrollador en el menú desplegable.