Acceso a una base de datos de Amazon Neptune desde un contenedor de Amazon EKS

Verifique el contexto del clúster.

Antes de interactuar con su clúster de Amazon EKS mediante Helm u otras herramientas de línea de comandos, debe definir las variables de entorno que encapsulen los detalles del clúster. Estas variables se utilizan en los comandos posteriores para garantizar que se dirijan al clúster y los recursos correctos.

En primer lugar, confirme que está trabajando en el contexto de clúster correcto. Esto garantiza que cualquier comando posterior se envíe al clúster de Kubernetes deseado. Para comprobar el contexto actual, ejecute el siguiente comando.

kubectl config current-context

Defina la variable CLUSTER_NAME.

Establezca la variable de entorno CLUSTER_NAME para el clúster de Amazon EKS. En el siguiente comando, sustituya el valor us-west-2 de muestra por el correcto Región de AWS para su clúster. Reemplace el valor de muestra eks-workshop por el nombre de su clúster existente.

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

Valide la salida.

Para comprobar que las variables se hayan configurado correctamente, ejecute el siguiente comando.

echo $CLUSTER_NAME

Compruebe que el resultado de este comando coincida con la entrada que especificó en el paso anterior.

Cree una cuenta de servicio de .

Utilice roles de IAM para cuentas de servicio y así poder asignar sus cuentas de servicio de Kubernetes a roles de IAM para habilitar una administración de permisos detallada en las aplicaciones que se ejecutan en Amazon EKS. Puede usar eksctl para crear y asociar un rol de IAM a una cuenta de servicio de Kubernetes específica dentro de su clúster de Amazon EKS. La política AWS administrada NeptuneFullAccess permite el acceso de escritura y lectura al clúster de Neptune especificado.

Cree una cuenta de servicio que desee asociar a una política AWS administrada denominadaNeptuneFullAccess.

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

eks-neptune-sa será el nombre de la cuenta de servicio que quiera crear.

Al finalizar, el comando muestra la siguiente respuesta:

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

Compruebe que la cuenta esté configurada correctamente.

Asegúrese de que la cuenta de servicio de eks-neptune-sa esté configurada correctamente en el espacio de nombres predeterminado del clúster.

kubectl get sa eks-neptune-sa -o yaml

La salida debe tener el siguiente aspecto:

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

Compruebe la conectividad.

Implemente un pod de muestra llamado pod-util y compruebe la conectividad con 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 la autenticación de bases de datos de IAM

De forma predeterminada, la autenticación de bases de datos de IAM está deshabilitada al crear un clúster de Neptune DB. Puede habilitar o deshabilitar la autenticación de la base de datos IAM mediante AWS Management Console.

Siga los pasos de la AWS documentación para habilitar la autenticación de bases de datos de IAM en Neptune.

Compruebe las conexiones.

En este paso, interactuará con el contenedor de pod-util, que ya está en ejecución, para instalar awscurl y comprobar la conexión.