Skip to content

Release 0.3.2 - Devcontainer Prerequisites Validation

Choose a tag to compare

@gerchowl gerchowl released this 10 Nov 17:57
· 29 commits to main since this release

🎯 Highlights

Comprehensive prerequisites validation system to prevent "login hell" when setting up devcontainers!

✨ Added

Devcontainer Prerequisites Validation

  • βœ… 5-step validation script (setup-user-conf.sh)
  • βœ… GHCR authentication check (Docker/Podman)
  • βœ… SSH public key validation (id_ed25519_github.pub)
  • βœ… Allowed-signers file check
  • βœ… Git configuration validation (user.name/email)
  • βœ… GitHub CLI authentication check
  • βœ… Detailed setup instructions for missing prerequisites
  • βœ… Clear distinction between required errors and optional warnings
  • βœ… Actionable commands to fix issues

πŸ“ Changed

README Documentation

  • Added prominent prerequisite validation tip in Requirements section
  • Created comprehensive "Host Machine Prerequisites" section
  • Added GHCR authentication setup with token creation steps
  • Documented Git configuration alternatives for SSH/remote scenarios
  • Added SSH key setup with specific naming requirements
  • Documented allowed-signers file setup
  • Added GitHub CLI authentication instructions
  • Created "Quick Validation - Test All Logins" section
  • Updated Quick Start with "Test All Logins and Prerequisites" step
  • Added note about Docker/Podman interchangeability

Setup Scripts

  • Enhanced setup-user-conf.sh with environment variable fallback
  • Added GIT_USER_NAME and GIT_USER_EMAIL environment variable support for SSH scenarios

πŸ› Fixed

  • Improved devcontainer setup UX by preventing "login hell"
  • Better error messaging for missing prerequisites
  • Clear guidance for SSH/remote server scenarios (#18)

πŸš€ Quick Start

Before opening the devcontainer, run:

.devcontainer/setup-user-conf.sh

This will validate all your logins and show you exactly what needs to be fixed!


Full Changelog: 0.3.1...0.3.2