lantern

wanderland-deployment-2025-12-04

Wanderland Deployment 2025-12-04

Date: December 4, 2025
Environment: devl → (preprod → prod to follow)
Status: In Progress 🔄

Overview

Initial deployment of Wanderland platform to Clarivate ECS infrastructure.

Components:

Service Image Port
Stuffy (Nightinggale) devops/stuffy 8080
Oculus API devops/oculus-api 7778

URLs (devl):

Instance Name: Nightinggale

Pre-Flight

Jenkins Job Created ✅

Infrastructure Prerequisites

  • EFS filesystem available (fs-a570b4ec)
  • ALB listener rules capacity on devops-utilities-arm64 cluster
  • ECR repositories created (devops/stuffy, devops/oculus-api)

Deployment Stages

Stage 1: Image Build

Status: Pending ⏳

Pipeline: pqis-devops-wanderland-devl-main-pipeline
Build: TBD
  • Stuffy Docker image built (ARM64)
  • Oculus API Docker image built (ARM64)
  • Images pushed to ECR

Stage 2: EFS Access Points

Status: Pending ⏳

  • /wanderland/devl/stuffy/data access point created
  • /wanderland/devl/stuffy/uploads access point created
  • /wanderland/devl/oculus/nodes access point created

Stage 3: Service Deployment

Status: Pending ⏳

  • Stuffy target group created
  • Stuffy ECS task registered
  • Stuffy ECS service created
  • Oculus API target group created
  • Oculus API ECS task registered
  • Oculus API ECS service created

Stage 4: Validation

Status: Pending ⏳

  • Stuffy health check passing (/api/health)
  • Oculus API health check passing (/health)
  • DNS resolution working
  • Target groups healthy

Execution Log

2025-12-04 ~15:20 EST

  • 🪿 Found fix in peregrine-multi-artifact-builds node
  • Applied pattern: builder config moved INTO each artifact
  • Changed builders: array → builder.type: artifacts delegator
  • Committed: cb1ce75 - "Fix multi-artifact build pattern for image stage"
  • Pushed to origin/main

2025-12-04 ~15:10 EST

  • Build #4 failed - NullPointerException: Cannot get property 'args' on null object
  • Root cause: Image stage builders: array not supported by 3.0.0-preview library
  • Library expects singular builder: structure, not multi-image builders: array
  • Investigating multi-image build options...

2025-12-04 ~11:00 EST

  • Updated URLs from stuffy.* to nightinggale.* for brand consistency
  • Changed STUFFY_INSTANCE_NAME to "Nightinggale"
  • Added post-deployment task: configure landing page with Florence Nightingale content
  • Awaiting CLI tooling before triggering first build

2025-12-04 ~10:30 EST

  • Explored repo structure and existing Jenkins configs
  • Reviewed methuselah job config as template
  • Created pqis-devops-wanderland-devl-main-pipeline job
  • Added job to nightinggale view
  • Created peregrine-jenkins-job-config documentation node

Next Steps

  • Trigger initial build
  • Monitor deployment stages
  • Verify services healthy

Rollback Plan

If deployment fails:

  • Check CloudWatch logs for container errors
  • Verify EFS access points exist and have correct permissions
  • Check ALB listener rule priorities (no conflicts)
  • If needed, delete CloudFormation stacks and retry

Post-Deployment Tasks

Landing Page Configuration

After deployment is complete, configure the main Stuffy landing page to display the Florence Nightingale content by default:

  • Source Node: florence-nightingale-visualization-pioneer
  • Target: Main page / landing page content
  • Rationale: The Lady with the Lamp represents the spirit of Nightinggale - data visualization as advocacy, making invisible problems visible, and using evidence to drive systemic reform.

"The very first requirement in a hospital is that it should do the sick no harm." — Florence Nightingale, 1859

This content sets the tone for what Nightinggale represents: the belief that systems can be understood, measured, and improved through evidence-based intervention.

# Check ECS service status
aws ecs describe-services --cluster devops-utilities-arm64 \
  --services wanderland-stuffy-devl wanderland-oculus-api-devl

# Force new deployment
aws ecs update-service --cluster devops-utilities-arm64 \
  --service wanderland-stuffy-devl --force-new-deployment

Related

  • Platform Architecture: [[wanderland-ecs-deployment]]
  • Jenkins Config Guide: [[peregrine-jenkins-job-config]]
  • Pipeline Config: devops-nightinggale/jenkins/deploy.yml

Tags

tags:
  - deployment
  - wanderland
  - ecs
  - devl
  - 2025-12

Slots

North

slots:
- wanderland-ecs-deployment
- wanderland-ecs-deployment

South

slots: []

East

slots: []

West

slots: []
↑ northwanderland-ecs-deployment