Esta página foi traduzida pela API Cloud Translation.

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

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. informações

Descontinuado : a execução do Edge Microgateway no Kubernetes usando o padrão de proxy de arquivo secundário é compatível. No entanto, o edgemicroctl e as ferramentas relacionadas descritas neste tópico estão obsoletos. Essas ferramentas dependem do injetor de arquivo secundário do Istio, que não é mais compatível.

Introdução

Neste tópico, explicamos como executar o Edge Microgateway em um cluster do Kubernetes como um proxy de arquivo secundário. Você tem duas opções para implantação de arquivo secundário: 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 volte ao estado de execução:
```
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á serviços "um de um" em execução no pod. Nas etapas a seguir, você configurará o cluster para que o Edge Microgateway seja injetado automaticamente como um arquivo secundário em qualquer novo pod criado. Quando isso acontecer, você verá ao executar kubectl get pods que há "dois de dois" serviços em execução no pod: o serviço e o arquivo secundário.
Exclua a implantação do serviço de teste. Você vai reinstalá-lo mais tarde, depois de ativar a injeção de arquivo secundário:
```
 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 injeção manual de sidecar é 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 da 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 de 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 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!

Injetar o Edge Microgateway como um arquivo secundário

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

onde:

your_org: a organização da Apigee que você especificou no comando edgemicro configure.
your_env: o ambiente especificado no comando edgemicro configure.
your_key: a chave retornada do 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 do comando edgemicro configure.
service_deployment_file: o caminho para o arquivo de implantação do serviço do pod que receberá o serviço de arquivo 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 do 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ê já pode testar a implantação do arquivo secundário 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 arquivo secundário para seu cluster do Kubernetes. Essa configuração permite que o Edge Microgateway seja injetado como um proxy de arquivo secundário no Kubernetes.

Instalar o injetor do sidecar

Instale o ConfigMap que permite a injeção de arquivo secundário do Edge Microgateway:
```
kubectl apply -f install/kubernetes/edgemicro-sidecar-injector-configmap-release.yaml
```
Execute o script a seguir para instalar o serviço webhook. O serviço de webhook é necessário para injeção automática de sidecar:

Observação :um serviço de webhook requer um par de certificado/chave assinado. O script a seguir gera um par de certificado/chave assinado pela autoridade certificadora (CA, na sigla em inglês) do Kubernetes. O arquivo de certificado/chave resultante é armazenado como um secret do Kubernetes para que o webhook do injetor do arquivo secundário consuma. A aprovação da CA do Kubernetes requer permissões para criar e aprovar a solicitação de assinatura de certificado (CSR, na sigla em inglês). Consulte também Como gerenciar TLs em um cluster e analise 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 CA 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 de arquivo secundário 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 arquivo secundário 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 arquivo secundário 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 arquivo secundário:

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ê executará um script interativo para criar uma configuração do Edge Microgateway associada a um namespace do Kubernetes. Em seguida, injetará 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 mais informações sobre os parâmetros de entrada, consulte a seção Referência de campo.

Entradas de amostra:
1. Namespace to deploy application [default]:
  
  Pressione Enter.
2. Authenticate with OAuth Token ("n","Y") [N/y]
  
  Digite n.
3. Apigee username [required]:
  
  Digite seu nome de usuário da Apigee (endereço de e-mail). Por exemplo, jdoe@google.com.
4. Apigee password [required]:
  
  Digite a senha da Apigee.
5. Apigee organization [required]:
  
  Insira o nome da sua organização da Apigee.
6. Apigee environment [required]:
  
  Insira um nome de ambiente para sua organização. Por exemplo, "teste".
7. Virtual Host [default]:
  
  Pressione Enter.
8. Is this Private Cloud ("n","y") [N/y]:
  
  Digite 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 ao script para uso não interativo. Acesse os comentários em ./install/kubernetes/webhook-edgemicro-patch.sh para saber mais.
Execute o comando da última linha da saída. Este 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, esse recurso 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 novamente o status da injeção de webhook. 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

Implante o serviço de teste

Agora, reimplante o serviço de teste. O Edge Microgateway vai 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ê já pode testar a implantação automática de arquivo secundário do Edge Microgateway. Acesse Testar o proxy para conferir as etapas detalhadas.

Testar o proxy

Com a implantação do arquivo secundário, um proxy de API para o seu serviço é criado automaticamente. Não é necessário criar um proxy "com reconhecimento do Edge Microgateway".

Conferir o endereço IP de entrada

Com o IP externo da entrada, é possível chamar o serviço de fora do cluster.

Consiga o endereço IP externo do controlador do Ingress:

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 da Entrada 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 fazer a configuração:

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ê resolverá o erro de autorização ausente configurando um produto de API e um app de desenvolvedor no Edge para receber uma chave de API válida. Quando você adicionar a chave a um cabeçalho de autorização para a chamada de API, a chamada será bem-sucedida e você não verá esse erro.

Criar componentes no Apigee Edge

Em seguida, crie um produto de API e um app de desenvolvedor na 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 é exibida.
Preencha a página do Produto da seguinte maneira: Para 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

Display Name 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 + API Proxy 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" será exibida.
Preencha a página do app do desenvolvedor da maneira a seguir. Não salve até receber a instrução para fazer isso.

Nome hello-world-app

Display Name 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ê está de 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 de Chave do cliente.
Copie o valor da chave do cliente. Esse valor é a chave de API que você usará para fazer chamadas de API seguras para o serviço helloworld.
Aguarde alguns minutos. Leva alguns minutos para que as alterações feitas no Apigee Edge sejam sincronizadas com a instância do Edge Microgateway implantada no cluster.

Observação: o Edge Microgateway pesquisa alterações feitas no Apigee Edge a cada 600 segundos (por padrão) e extrai todas as alterações de configuração feitas em proxies, produtos de API e apps de desenvolvedor. Para alterar o padrão dos anos 600, edite o arquivo de configuração do Edge Microgateway. Consulte a documentação do Edge Microgateway para mais detalhes.

Chamar a API

Depois que as alterações de configuração forem enviadas ao microgateway, realize os testes a seguir.

Chamar a API sem uma chave. Você receberá uma mensagem de erro, conforme mostrado abaixo:
```
curl $GATEWAY_IP
```
Saída esperada:
```
{"error":"missing_authorization","error_description":"Missing Authorization
header"}
```
Para fazer chamadas de API, você precisa da chave de API.
Acesse a chave do cliente no app do desenvolvedor que você criou. Esse valor é a chave de API que você precisa para chamar 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 PROVIDER implantado no pod. A chamada para esse serviço passou primeiro pelo Edge Microgateway, em que a autenticação foi realizada. Se você vir a resposta "Hello world", significa que você configurou o Edge Microgateway para funcionar como um proxy de arquivo secundário no pod de serviço gcr.

A seguir

Consulte a seção Tarefas para ver informações sobre como adicionar plug-ins personalizados, escalonar a implantação, fazer alterações de configuração e outras tarefas que você pode executar.

Nome	`hello-world-product`
Display Name	`Edge Micro hello product`
Ambiente	`test`

Nome	`hello-world-app`
Display Name	`Edge Micro hello app`
Desenvolvedor	Selecione um desenvolvedor no menu suspenso.