docs: update production deployment workflow and runbook - #63
Merged
Dereje1 merged 1 commit intoJul 16, 2026
Merged
Conversation
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## master #63 +/- ##
=======================================
Coverage 98.61% 98.61%
=======================================
Files 50 50
Lines 1805 1805
Branches 312 312
=======================================
Hits 1780 1780
Misses 24 24
Partials 1 1 ☔ View full report in Codecov by Harness. 🚀 New features to boost your workflow:
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation
linux/amd64Docker builds, local runtime testing, pushing a tested image to private ECR, and deploying via a minimalDockerrun.aws.jsonbundle.Description
DEPLOYMENT.mdinto a comprehensive manual runbook that documents: source-state verification,linux/amd64docker buildxcommands, local image testing, ECR login/tag/push/verify steps,Dockerrun.aws.jsontemplate, minimal ZIP creation, application-version registration, EBupdate-environmentdeployment, macOS-compatible monitoring loops, verification checks, rollback, and troubleshooting for ECR-based deployments.README.mdDocker and Production Deployment sections to: showdocker buildxtargetinglinux/amd64, a productiondocker runexample, clarify that.envis runtime-only, and replace claims that EB builds the rootDockerfilewith the new ECR +Dockerrun.aws.jsonflow.Dockerfile,.env,node_modules, etc.).<AWS_ACCOUNT_ID>,<AWS_REGION>,<ECR_REPOSITORY_URI>,<IMAGE_TAG>,<EB_APPLICATION_VERSION>, etc.) and preserves production domain, CloudFront, Route 53, MongoDB, S3, and OAuth references where still valid.Testing
git diff --checkand a targeted grep scan for stale or secret-containing patterns (searching for phrases like "Elastic Beanstalk will build the Docker image",pinterest-clone-deploy.zip, account-number-style ECR URIs, ARNs, and access-key patterns), both checks passed against the modified files.DEPLOYMENT.mdandREADME.md.npm run compileTS,npm run lint,npm test,npm run build_server, ornpm run build_clientbecause this is a documentation-only PR and no application or infra code was modified.Codex Task