Skip to main content

EKS

The RTGS.global Signing Module can be deployed to Amazon EKS using the Helm chart and the provided deploy scripts.

Prerequisites

The following cluster prerequisites are installed automatically by helm-up-eks.sh if not already present:

PrerequisitePurpose
ingress-nginxProvisions an AWS load balancer via the nginx ingress controller
metrics-serverRequired for horizontal pod autoscaling (usually pre-installed on EKS)
CloudNativePGPostgreSQL operator that backs the wallet store
cert-managerIssues automatic Let's Encrypt TLS certificates for ingress hosts

You will also need:

  • Let's Encrypt account email (ACME_EMAIL) — used to create the letsencrypt-prod ClusterIssuer. A valid email address is required by Let's Encrypt for certificate issuance and renewal notices.

Configure values

Copy the provided values-savy-eks.yaml and fill in all <placeholder> values. The deploy script refuses to run against a file that still contains them.

Download values-savy-eks.yaml

Key fields:

FieldDescription
admin.apiKeyShared key between the signing service and the Aries admin API
wallet.seedFrom the onboarding email — derives your DID/Verkey on the Indicio ledger
wallet.keyWallet encryption key; generate a new GUID for a fresh installation
environment.rtgsGlobalIdFrom the onboarding email, e.g. RTGS:B:GB00000000
environment.rtgsInvitationBase-64 encoded invitation from the onboarding email
environment.jurisdictionJurisdiction code from the onboarding email, e.g. euwsbx
hosts.signing_servicePublic hostname for the signing service
hosts.didcomm_agentPublic hostname for the DIDComm agent
hosts.svixPublic hostname for the Svix webhook server
postgresql.auth.passwordPostgreSQL password
svix.jwtSecretSvix JWT signing secret
svix.endpointsOne or more uid/url pairs to receive webhook event deliveries

Deploy

ACME_EMAIL=you@example.com VALUES=./values-savy-eks.<cluster>.yaml ./helm-up-eks.sh

DNS alias records are registered automatically in Route 53 if a hosted zone is found for the ingress hostnames. To target a specific zone:

ACME_EMAIL=you@example.com VALUES=./values-savy-eks.<cluster>.yaml ROUTE53_ZONE_ID=Z1234567890ABC ./helm-up-eks.sh

Additional options:

VariableDefaultDescription
RELEASErtgs-signingHelm release name
NAMESPACErtgs-signingTarget namespace
CONTEXTcurrent contextkubectl context (must be a cloud/EKS context)
CHART_VERSIONlatestSpecific chart version to deploy

Download helm-up-eks.sh

Uninstall

Download helm-down-eks.sh

warning

The Aries DIDComm Agent receives encrypted callbacks from other agents on the network and must be accessible to the internet. Protect it from DDoS and similar risks by fronting it with a reverse proxy such as Nginx.