Acesso a um banco de dados do Amazon Neptune usando um contêiner do Amazon EKS

Verifique o contexto do cluster.

Antes de interagir com o cluster do Amazon EKS usando o Helm ou outras ferramentas de linha de comando, você deve definir variáveis de ambiente que contenham os detalhes do cluster. As variáveis definidas serão usadas nos próximos comandos para garantir que todas as ações sejam direcionadas ao cluster e aos recursos corretos.

Primeiro, confirme que você está operando no contexto correto do cluster. Dessa forma, você garante que quaisquer comandos executados a seguir sejam aplicados ao cluster do Kubernetes correto. Para verificar o contexto atual, execute o comando apresentado a seguir.

kubectl config current-context

Defina a variável CLUSTER_NAME.

Defina a variável de ambiente CLUSTER_NAME para o cluster do Amazon EKS. No comando apresentado a seguir, substitua o valor de amostra us-west-2 pela Região da AWS correta do seu cluster. Substitua o valor de amostra eks-workshop pelo nome do seu cluster existente.

export CLUSTER_NAME=$(aws eks describe-cluster --region us-west-2 --name eks-workshop --query "cluster.name" --output text)

Valide a saída.

Para validar se as variáveis foram definidas corretamente, execute o comando apresentado a seguir.

echo $CLUSTER_NAME

Verifique se a saída deste comando corresponde à entrada que você especificou na etapa anterior.

Criar uma conta de serviço do .

Com os perfis do IAM para contas de serviço, você pode mapear as contas de serviço do Kubernetes para perfis do IAM a fim de possibilitar um gerenciamento de permissões detalhado para as aplicações executadas no Amazon EKS. É possível usar a ferramenta eksctl para criar e associar um perfil do IAM a uma conta de serviço específica do Kubernetes dentro do seu cluster do Amazon EKS. A política NeptuneFullAccess, gerenciada pela AWS, permite acesso de leitura e gravação ao cluster do Neptune especificado.

Crie uma conta de serviço que você deseja associar a uma política gerenciada pela AWS chamada NeptuneFullAccess.

eksctl create iamserviceaccount --name eks-neptune-sa --namespace default --cluster $CLUSTER_NAME --attach-policy-arn arn:aws:iam::aws:policy/NeptuneFullAccess --approve --override-existing-serviceaccounts

em que eks-neptune-sa consiste no nome da conta de serviço que você deseja criar.

Quando o comando for concluído, ele mostrará a seguinte resposta:

2024-02-07 01:12:39 [ℹ] created serviceaccount "default/eks-neptune-sa"

Verifique se a conta foi configurada corretamente.

Certifique-se de que a conta de serviço eks-neptune-sa foi configurada corretamente no namespace padrão do seu cluster.

kubectl get sa eks-neptune-sa -o yaml

O resultado deve ser semelhante ao seguinte:

apiVersion: v1
kind: ServiceAccount
metadata:
  annotations:
    eks.amazonaws.com/role-arn: arn:aws:iam::123456789123:role/eksctl-eks-workshop-addon-iamserviceaccount-d-Role1-Q35yKgdQOlmM
  creationTimestamp: "2024-02-07T01:12:39Z"
  labels:
    app.kubernetes.io/managed-by: eksctl
  name: eks-neptune-sa
  namespace: default
  resourceVersion: "5174750"
  uid: cd6ba2f7-a0f5-40e1-a6f4-4081e0042316

Verifique a conectividade.

Implante um pod de amostra chamado pod-util e verifique a conectividade com o Neptune.

apiVersion: v1
kind: Pod
metadata:
  name: pod-util
  namespace: default
spec:
  serviceAccountName: eks-neptune-sa
  containers:
  - name: pod-util
    image: public.ecr.aws/patrickc/troubleshoot-util
    command:
      - sleep
      - "3600"
    imagePullPolicy: IfNotPresent

kubectl apply -f pod-util.yaml

kubectl exec --stdin --tty pod-util -- /bin/bash
bash-5.1# curl -X POST -d '{"gremlin":"g.V().limit(1)"}' https://db-neptune-1.cluster-xxxxxxxxxxxx.us-west-2.neptune.amazonaws.com:8182/gremlin
{"requestId":"a4964f2d-12b1-4ed3-8a14-eff511431a0e","status":{"message":"","code":200,"attributes":{"@type":"g:Map","@value":[]}},"result":{"data":{"@type":"g:List","@value":[]},"meta":{"@type":"g:Map","@value":[]}}}
bash-5.1# exit
exit

Habilite a autenticação do banco de dados do IAM.

Por padrão, a autenticação de banco de dados do IAM está desabilitada quando você cria um cluster de banco de dados do Neptune. É possível habilitar ou desabilitar a autenticação do banco de dados do IAM usando o Console de gerenciamento da AWS

Siga as etapas apresentadas na documentação da AWS para habilitar a autenticação do banco de dados do IAM no Neptune.

Verifique as conexões.

Nesta etapa, você interage com o contêiner pod-util, que já está em execução, para instalar a ferramenta awscurl e verificar a conexão.