Esta página foi traduzida pela API Cloud Translation.

Implantar o Edge Microgateway como um proxy de arquivo secundário

Você está visualizando a documentação do Apigee Edge.
Acesse a documentação da Apigee X. info

OBSOLETO : o Microgateway de borda em execução no Kubernetes usando o padrão de proxy de sidecar tem suporte. No entanto, o edgemicroctl e as ferramentas relacionadas descritas neste tópico foram descontinuadas. Essa ferramenta depende do injetor de sidecar do Istio, que não é mais compatível.

Introdução

Este tópico explica como executar o Edge Microgateway em um cluster do Kubernetes como um proxy sidecar. Você tem duas opções para a implantação do sidecar: injeção manual e automática. Este tópico descreve as duas opções.

Para mais informações, consulte Introdução ao Edge Microgateway no Kubernetes.

Antes de começar

Conclua as etapas descritas em Pré-requisitos.

Implantar um serviço de teste

Implante um serviço "hello" simples e verifique a implantação:

Implante a amostra:

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

Verifique se o serviço está em execução. Talvez seja necessário aguardar alguns instantes até que o pod seja iniciado:
```
kubectl get pods --namespace=default
```
Exemplo de saída:
```
NAME                          READY     STATUS    RESTARTS   AGE
helloworld-569d6565f9-lwrrv   1/1       Running   0          17m
```
Observação: o status READY de 1/1 significa que há um serviço em execução no pod. Nas etapas a seguir, você vai configurar o cluster para que o Edge Microgateway seja injetado automaticamente como um sidecar em todos os pods novos que você criar. Quando isso acontecer, você vai notar ao executar kubectl get pods que há dois serviços em execução no pod: o serviço e o sidecar.
Exclua a implantação do serviço de teste. Reinstale-o depois de ativar a injeção de sidecar:
```
 kubectl delete -f samples/helloworld/helloworld.yaml --namespace=default
```

Como usar a injeção manual de sidecar

Das duas opções de injeção de sidecar, a manual é a abordagem mais simples e direta, e pode ser feita com um único comando kubectl.

Configurar o Edge Microgateway

O comando a seguir configura o Edge Microgateway para sua organização do Apigee e implanta o proxy edgemicro-auth.

Execute o seguinte comando:

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

Em que:

org: o nome da sua organização do Edge (você precisa ser um administrador da organização).
env: um ambiente na sua organização (como teste ou produção).
username: o endereço de e-mail associado à sua conta da Apigee.

Exemplo

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

A saída (exemplo mostrado abaixo) é salva no arquivo:

$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!

Injete o Edge Microgateway como um arquivo secundário

Para injetar manualmente o Edge Microgateway em um pod de serviço como um proxy de sidecar, execute 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)

em que:

your_org: a organização da Apigee especificada no comando edgemicro configure.
your_env: o ambiente especificado no comando edgemicro configure.
your_key: a chave retornada pelo comando edgemicro configure.
your_secret: o secret retornado do comando edgemicro configure.
config_file_path: o caminho para o arquivo de configuração do Edge Micro retornado pelo comando edgemicro configure.
service_deployment_file: o caminho para o arquivo de implantação do serviço do pod que vai receber o serviço secundário complementar. Por exemplo, samples/helloworld/helloworld.yaml.

Exemplo:

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)

Testar a configuração

Verifique as implantações de serviço:

kubectl get services -n default

Exemplo de saída:

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

Agora você está pronto para testar a implantação do sidecar do Edge Microgateway. Acesse Testar o proxy para conferir as etapas detalhadas.

Como usar a injeção automática de sidecar

Nas etapas a seguir, você vai configurar a injeção automática de sidecar para seu cluster do Kubernetes. Essa configuração permite que o Edge Microgateway seja injetado como um proxy sidecar no Kubernetes.

Instalar o injetor do sidecar

Instale o ConfigMap que ativa a injeção de sidecar do Edge Microgateway:

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

Execute o script a seguir para instalar o serviço de webhook. O serviço de webhook é necessário para injeção automática de sidecar:

Observação: um serviço de webhook exige um par de chave/certificado assinado. O script a seguir gera um par de certificado/chave assinado pela autoridade certificadora (AC) do Kubernetes. O arquivo de certificado/chave resultante é armazenado como um secret do Kubernetes para que o webhook do injetor de sidecar seja consumido. A aprovação da AC do Kubernetes requer permissões para criar e aprovar a solicitação de assinatura de certificado (CSR). Consulte também Como gerenciar tls em um cluster e examine o script install/kubernetes/webhook-create-signed-cert.sh para mais informações.
```
./install/kubernetes/webhook-create-signed-cert.sh \
    --service edgemicro-sidecar-injector \
    --namespace edgemicro-system \
    --secret sidecar-injector-certs
```

Adicione o pacote de AC ao arquivo de instalação do webhook. O api-server do Kubernetes usa esse arquivo para invocar o webhook:

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

Instale o webhook do injetor do sidecar do Edge Microgateway:

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

Exemplo de saída:

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

Verifique se o webhook do injetor de sidecar do Edge Microgateway está em execução:

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

Exemplo de saída:

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

Verifique se o pod de injeção do sidecar está em execução no cluster. O namespace edgemicro-system é onde os serviços do sistema são instalados, incluindo o controlador de entrada, o back-end HTTP padrão e o injetor de sidecar:

kubectl get pods -n edgemicro-system

Exemplo de saída:

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

Configurar e injetar o Edge Microgateway

Na próxima etapa, você vai executar um script interativo para criar uma configuração do Edge Microgateway associada a um namespace do Kubernetes. Em seguida, injete a configuração no cluster do Kubernetes.

Execute o script interativo a seguir e forneça os parâmetros solicitados. O comando gera um perfil de configuração que você vai usar na próxima etapa.
```
./install/kubernetes/webhook-edgemicro-patch.sh
```
Para informações sobre os parâmetros de entrada, consulte Referência.

Exemplos de entradas:
1. Namespace to deploy application [default]:
  
  Pressione Enter.
2. Authenticate with OAuth Token ("n","Y") [N/y]
  
  Insira n.
3. Apigee username [required]:
  
  Insira seu nome de usuário do Apigee (endereço de e-mail). Por exemplo, jdoe@google.com.
4. Apigee password [required]:
  
  Digite sua senha da Apigee.
5. Apigee organization [required]:
  
  Digite o nome da sua organização da Apigee.
6. Apigee environment [required]:
  
  Insira um nome de ambiente para sua organização. Por exemplo, "test".
7. Virtual Host [default]:
  
  Pressione Enter.
8. Is this Private Cloud ("n","y") [N/y]:
  
  Insira n se você estiver na nuvem pública.
9. Edgemicro Key. Press Enter to generate:
  
  Pressione Enter.
10. Edgemicro Secret. Press Enter to generate:
  
  Pressione Enter.
11. Edgemicro org-env-config.yaml. Press Enter to generate:
  
  Pressione Enter.
  
  Exemplo de saída:
```
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]:
  
  Digite y.
  
  Exemplo de saída:
```
Configuring Microgateway with

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

********************************************************************************************************
kubectl apply -f install/kubernetes/edgemicro-config-namespace-bundle.yaml
********************************************************************************************************
```
Observação: também é possível transmitir parâmetros para o script para uso não interativo. Consulte os comentários em ./install/kubernetes/webhook-edgemicro-patch.sh para saber mais.
Execute o comando fornecido na última linha da saída. Esse comando kubectl injeta o perfil de configuração do Edge Microgateway gerado no Kubernetes:
```
kubectl apply -f install/kubernetes/edgemicro-config-namespace-bundle.yaml
```

Confira o status da injeção de webhook. No momento, ele não está ativado:

kubectl get namespace -L edgemicro-injection

Exemplo de saída:

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

Execute este comando para ativar a injeção de webhook:

kubectl label namespace default edgemicro-injection=enabled

Confira o status da injeção de webhook novamente. Agora ele está ativado:

kubectl get namespace -L edgemicro-injection

Exemplo de saída:

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

Implantar o serviço de teste

Agora, reimplante o serviço de teste. O Edge Microgateway será injetado automaticamente no pod do serviço.

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

Confirme se o Edge Microgateway foi injetado no pod com o serviço de teste:

kubectl get pods --namespace=default --watch

Exemplo de saída:

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

Quando o status mudar para Running, pressione ctrl-c para sair do comando.

Agora você está pronto para testar a implantação automática de sidecar do Edge Microgateway. Acesse Testar o proxy para conferir as etapas detalhadas.

Testar o proxy

Com a implantação de sidecar, um proxy de API para seu serviço é criado automaticamente. Não é preciso criar um proxy "compatível com o Edge Microgateway".

Acessar o endereço IP de entrada

Com o IP externo para o Ingress, é possível chamar o serviço fora do cluster.

Encontre o endereço IP externo do controlador de entrada:

kubectl get ing -o wide

Exemplo de saída:

NAME      HOSTS     ADDRESS        PORTS     AGE
gateway   *         35.238.13.54   80        1m

Copie o valor EXTERNAL-IP do Ingress e exporte-o para uma variável. É possível definir a variável manualmente:

export GATEWAY_IP=external_ip

Exemplo:

export GATEWAY_IP=35.238.249.62

Ou use este comando para configurá-lo:

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

Verifique se a variável foi exportada. Exemplo:
```
echo $GATEWAY_IP
```
Exemplo de saída:
```
35.238.249.62
```
Chame o serviço:
```
curl $GATEWAY_IP
```
Saída:
```
{"error":"missing_authorization","error_description":"Missing Authorization header"}
```
Em seguida, você vai resolver o erro de autorização ausente configurando um produto de API e um app de desenvolvedor no Edge para conseguir uma chave de API válida. Quando você adiciona a chave a um cabeçalho de autorização para a chamada de API, a chamada é bem-sucedida e esse erro não aparece.

Criar componentes no Apigee Edge

Em seguida, crie um produto de API e um app de desenvolvedor no Apigee Edge.

Criar um produto da API

Faça login no Apigee Edge.
Selecione Publicar > Produtos da API no menu de navegação lateral.
Clique em + Produto da API. A página do produto aparece.
Preencha a página do produto da seguinte maneira. Para os campos não mencionados abaixo, use os valores padrão. Não salve até receber uma instrução para fazer isso.

Nome hello-world-product

Nome de exibição Edge Micro hello product

Ambiente test
Na seção "Caminho", clique em + Recurso personalizado.
Adicione o caminho /.
Clique em + Recurso personalizado novamente e adicione o caminho /**.
Na seção "API Proxies", clique em + Proxy de API e adicione edgemicro-auth.
Salve o produto da API.

Criar um app do desenvolvedor

Selecione Apps no menu de navegação lateral.
Clique em + App. A página "Detalhes do app do desenvolvedor" vai aparecer.
Preencha a página do app do desenvolvedor da maneira a seguir. Não salve até receber uma instrução para fazer isso.

Nome hello-world-app

Nome de exibição Edge Micro hello app

Desenvolvedor Selecione um desenvolvedor no menu suspenso.
Na seção "Credenciais", clique em + Produto e selecione o hello-world-product que você acabou de criar.
Clique em Salvar.
Você volta à página que lista todos os apps do desenvolvedor.
Selecione o app que você acabou de criar, hello-world-app.
Clique em Mostrar ao lado da chave de cliente.
Copie o valor da chave do consumidor. Esse valor é a chave de API que você vai usar para fazer chamadas de API seguras para o serviço helloworld.
Aguarde alguns minutos. As mudanças feitas no Apigee Edge levam alguns minutos para serem sincronizadas com a instância do Edge Microgateway implantada no cluster.

Observação: o microgateway do Edge verifica se há mudanças no Apigee Edge a cada 600 segundos (por padrão) e puxa para baixo todas as mudanças de configuração feitas em proxies, produtos de API e apps de desenvolvedor. É possível mudar o padrão de 600s editando o arquivo de configuração da microgateway do Edge. Consulte a documentação do Edge Microgateway para mais detalhes.

Chamar a API

Depois que as mudanças de configuração forem puxadas para o microgateway, você poderá realizar os seguintes testes.

Chamar a API sem uma chave de API. Você vai receber uma mensagem de erro, como mostrado abaixo:
```
curl $GATEWAY_IP
```
Saída esperada:
```
{"error":"missing_authorization","error_description":"Missing Authorization
header"}
```
Para fazer chamadas de API bem-sucedidas, você precisa da chave de API.
Extraia a chave do cliente do app de desenvolvedor que você criou. Esse valor é a chave da API que você precisa chamar para o proxy de teste:
```
curl -H 'x-api-key:your-edge-api-key'  $GATEWAY_IP
```
Exemplo:
```
curl -H "x-api-key:DeX2eEesYAdRJ5Gdbo77nT9uUfJZql19" $GATEWAY_IP
```
Saída:
```
Hello world
```
A resposta "Hello world" é retornada pelo serviço helloworld implantado no pod. A chamada para esse serviço passou primeiro pelo Edge Microgateway, onde a autenticação foi realizada. Se você receber a resposta "Hello world", o Edge Microgateway foi configurado para funcionar como um proxy de sidecar no pod de serviço helloworld.

A seguir

Consulte a seção Tarefas para saber como adicionar plug-ins personalizados, dimensionar implantações, fazer mudanças de configuração e realizar outras tarefas.

Nome	`hello-world-product`
Nome de exibição	`Edge Micro hello product`
Ambiente	`test`

Nome	`hello-world-app`
Nome de exibição	`Edge Micro hello app`
Desenvolvedor	Selecione um desenvolvedor no menu suspenso.