Acesse um banco de dados Amazon Neptune a partir de um contêiner Amazon EKS

Verifique o contexto do cluster.

Antes de interagir com seu cluster Amazon EKS usando o Helm ou outras ferramentas de linha de comando, você deve definir variáveis de ambiente que encapsulem os detalhes do seu cluster. Essas variáveis são usadas em comandos subsequentes para garantir que elas tenham como alvo o cluster e os recursos corretos.

Primeiro, confirme se você está operando no contexto correto do cluster. Isso garante que todos os comandos subsequentes sejam enviados para o cluster Kubernetes pretendido. Para verificar o contexto atual, execute o comando a seguir.

kubectl config current-context

Defina a CLUSTER_NAME variável.

Defina a variável de CLUSTER_NAME ambiente para seu cluster Amazon EKS. No comando a seguir, substitua o valor us-west-2 da amostra pelo correto Região da AWS para seu cluster. Substitua o valor eks-workshop da amostra pelo nome do 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 a seguir.

echo $CLUSTER_NAME

Verifique se a saída desse comando corresponde à entrada especificada na etapa anterior.

Criar uma conta de serviço do .

Você usa funções do IAM para contas de serviço para mapear suas contas de serviço do Kubernetes para funções do IAM, a fim de permitir o gerenciamento refinado de permissões para seus aplicativos que são executados no Amazon EKS. Você pode usar eksctl para criar e associar uma função do IAM a uma conta de serviço específica do Kubernetes dentro do seu cluster Amazon EKS. A política AWS gerenciada NeptuneFullAccess permite acesso de gravação e leitura ao cluster Neptune especificado.

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

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

onde eks-neptune-sa está o nome da conta de serviço que você deseja criar.

Após a conclusão, esse comando exibe a seguinte resposta:

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

Verifique se a conta está configurada corretamente.

Certifique-se de que a conta eks-neptune-sa de serviço esteja 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

Ative 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. Você pode ativar ou desativar a autenticação do banco de dados do IAM usando AWS Management Console o.

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

Verifique as conexões.

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