Saltar al contenido principal

Despliegue

Despliegue mediante Helm Charts​

Requisitos mínimos del sistema​

  • Cuentas Stellar: Necesitarás una Cuenta de Distribución (con fondos) y una Cuenta de Firma SEP-10.
  • Certificados: Al ejecutar el SDP en una configuración multiusuario, necesitarás adquirir certificados TLS comodín para facilitar la provisión de usuarios, ya que el SDP utiliza subdominios para diferenciar entre ellos. Esto te permitirá provisionar usuarios sin tener que configurar manualmente certificados TLS para cada uno. Puedes usar un servicio como Let's Encrypt o Namecheap para obtener estos certificados.
ComponenteRequisitoNotas
Kubernetesv1.19+Para despliegue con Helm
Helmv3.14.0+Para despliegue con Helm
PostgreSQLv14.0+Requerido para ambos métodos de despliegue
RAM4GB+Memoria mínima recomendada para ejecutar la pila completa en modo multiusuario

Instalando el Chart​

1. Agregar el Repositorio Helm de Stellar​

Agrega el repositorio oficial de charts Helm de Stellar a tu cliente Helm local:

helm repo add stellar https://helm.stellar.org/charts

2. Preparar la Configuración​

Descarga el archivo de configuración mínima para usarlo como base:

curl -LJO https://raw.githubusercontent.com/stellar/stellar-disbursement-platform-backend/main/helmchart/sdp/minimal-values.yaml

Los siguientes parámetros pueden establecerse en el archivo minimal-values.yaml o sobrescribirse directamente mediante la CLI durante la instalación:

  • global.distributionPublicKey: Clave pública de la cuenta de distribución.
  • global.distributionPrivateKey: Clave privada de la cuenta de distribución.
  • global.sep10PublicKey: Clave pública para la autenticación SEP-10.
  • global.sep10PrivateKey: Clave privada para la autenticación SEP-10.
  • global.isPubnet: Establecer en true para Mainnet.

Consulta el README del Helm Chart para obtener una lista completa de parámetros.

consejo

Hay una explicación más detallada de cómo configurar el SDP en la Guía de Configuración.

3. Instalar el Chart​

Instala el chart usando tu archivo de valores personalizado. Puedes sobrescribir valores directamente mediante la CLI o modificar el archivo minimal-values.yaml.

helm install sdp -f minimal-values.yaml stellar/stellar-disbursement-platform \
     --set "global.distributionPublicKey=<YOUR_KEY>" \
     --set "global.distributionPrivateKey=<YOUR_SECRET>" \
     --set "global.sep10PublicKey=<YOUR_KEY>" \
     --set "global.sep10PrivateKey=<YOUR_SECRET>"

Despliegue mediante Docker Compose​

Esta sección describe cómo desplegar el SDP usando Docker Compose para un entorno similar a producción. A diferencia de la configuración de desarrollo, esta configuración usa imágenes precompiladas para producción y requiere la configuración explícita de variables de entorno y secretos.

Requisitos mínimos del sistema​

  • Cuentas Stellar: Necesitarás una Cuenta de Distribución (con fondos) y una Cuenta de Firma SEP-10.
  • Acceso a la red: Acceso de salida a la red Stellar (Horizon/Soroban) y a cualquier integración de terceros (Twilio, AWS SES, etc.).
ComponenteRequisitoNotas
Dockerv20.10+Requerido para la orquestación de contenedores
RAM4GB+Memoria mínima recomendada para ejecutar la pila completa

Pasos para el despliegue​

1. Clona el Repositorio​

git clone https://github.com/stellar/stellar-disbursement-platform-backend.git
cd stellar-disbursement-platform-backend

2. Crear archivo de entorno​

Copia el archivo de entorno de ejemplo.

cp dev/.env.example dev/.env

3. Configura las variables de entorno​

Edita dev/.env y completa las siguientes variables con las claves de tus cuentas Stellar:

  • DISTRIBUTION_PUBLIC_KEY
  • DISTRIBUTION_SEED
  • SEP10_SIGNING_PUBLIC_KEY
  • SEP10_SIGNING_PRIVATE_KEY

Para despliegue en mainnet, establece: _ NETWORK_TYPE=pubnet _ NETWORK_PASSPHRASE=Public Global Stellar Network ; September 2015 _ HORIZON_URL=https://horizon.stellar.org _ DISABLE_MFA=false (Impuesto por seguridad)

4. Iniciar los Servicios​

docker compose -f dev/docker-compose.yml up -d