Skip to content

AMI: AWS-compliant first-boot credentials + remove AMI from public docs#22

Merged
Nexus-ABC merged 2 commits into
mainfrom
chore/ami-creds-and-public-doc-cleanup
May 29, 2026
Merged

AMI: AWS-compliant first-boot credentials + remove AMI from public docs#22
Nexus-ABC merged 2 commits into
mainfrom
chore/ami-creds-and-public-doc-cleanup

Conversation

@Nexus-ABC
Copy link
Copy Markdown
Contributor

Summary

Two related AMI/appliance changes:

  1. AWS Marketplace credential compliance — first-boot admin credentials now satisfy AWS Marketplace AMI policy (generated on first boot, read-once file in /root, 0600, root-only, deleted after first read). Previously written to /var/log/nexus/admin-credentials.txt (0640 root:nexus), which fails review on both path and permissions.

  2. Remove AMI/appliance from public docs — the AMI/appliance form factor stays a working build dir under nexus-ami/, but is no longer advertised in the public README, docs, or wiki. Also fixes the README CI badge URLs that pointed at the placeholder your-org/abc-nexus-gateway.

Changes

Credentials (fix(ami))

  • nexus-ami/scripts/first-boot-db.sh: write /root/nexus-admin-credentials.txt, chmod 0600 + chown root:root, updated in-file note + /etc/motd
  • nexus-ami/scripts/harden.sh: wipe the new /root path at build time (kept the legacy /var/log wipe defensively)
  • nexus-ami/README.md: manual-test step points at the new path

Docs (docs)

  • README.md: repoint CI/Go-CI badges to AlphaBitCore/nexus-gateway; remove AMI + bare-metal-appliance rows from the Deployment table
  • docs/operators/README.md: drop the ami-build.md index entry
  • docs/developers/architecture/README.md: remove the now-empty "Cross-cutting — deployment" trigger-map section
  • Deleted docs/operators/ops/ami-build.md and docs/developers/architecture/cross-cutting/deployment/ami-appliance-architecture.md
  • Makefile, .gitignore: drop comment lines citing the deleted arch doc (build targets / ignore rules kept)

Verification

  • check:arch-doc-triggers → OK (no orphaned trigger row, no missing-doc reference)
  • check:doc-lockstep → clean
  • grep for nexus-ami | ami-build | ami-appliance | AWS Marketplace | single-instance appliance across README + docs → none remaining
  • bash -n passes on both edited shell scripts

🤖 Generated with Claude Code

Nexus-ABC and others added 2 commits May 29, 2026 23:18
AWS Marketplace AMI policy requires default admin credentials to be
generated on first boot (not baked into the AMI) and stored as a
read-once file outside /var/log, mode 0600, owned by root only, with
instructions to delete after first read.

- first-boot-db.sh: write /root/nexus-admin-credentials.txt (was
  /var/log/nexus/admin-credentials.txt), chmod 0600 + chown root:root,
  update the in-file IMPORTANT note and /etc/motd
- harden.sh: wipe the new /root path at build time (kept the legacy
  /var/log wipe defensively) so no copy is baked into the image
- nexus-ami/README.md: point the manual-test step at the new path

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- README.md: CI/Go-CI badge links pointed at the placeholder
  your-org/abc-nexus-gateway; repoint at AlphaBitCore/nexus-gateway.
  Remove the AWS Marketplace AMI and bare-metal-appliance rows from the
  Deployment table.
- docs/operators/README.md: drop the ami-build.md index entry.
- docs/developers/architecture/README.md: remove the now-empty
  "Cross-cutting - deployment" trigger-map section.
- Makefile, .gitignore: drop comment lines citing the deleted AMI
  architecture doc (build targets / ignore rules kept).

The AMI/appliance form factor stays a working build dir under nexus-ami/
but is no longer advertised in the public README, docs, or wiki.

Verified: check:arch-doc-triggers OK, check:doc-lockstep clean, and no
nexus-ami / ami-build / ami-appliance references remain in README or docs.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@Nexus-ABC Nexus-ABC merged commit 3abdafa into main May 29, 2026
5 checks passed
@Nexus-ABC Nexus-ABC deleted the chore/ami-creds-and-public-doc-cleanup branch June 3, 2026 15:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant