Skip to content

Conversation

@richardkiene
Copy link
Contributor

Summary

  • Add proper Dev Container Template structure in src/liquescent-devcontainer/
  • Make repository compliant with the Dev Container Template specification
  • Support both pre-built image and template distribution methods
  • Add comprehensive 1Password domain support to firewall
  • Fix environment variable issues with 1Password CLI

Changes

Dev Container Template Structure

  • Created src/liquescent-devcontainer/ directory with proper template structure
  • Added devcontainer-template.json with template metadata and configuration options
  • Copied all necessary devcontainer files to template directory
  • Added template-specific README with usage instructions

1Password Improvements

  • Added 1Password domains to firewall allowlist for CLI authentication
  • Fixed empty environment variable interference with service account tokens
  • Updated setup script to unset empty Connect variables
  • Improved documentation for manual service account configuration

Documentation Updates

  • Updated main README to explain both distribution methods (image vs template)
  • Removed outdated TEMPLATE_USAGE.md file
  • Added notes about default allowed domains including 1Password

Impact

  • Repository is now fully compliant with Dev Container Template specification
  • Users can choose between fast pre-built image or customizable template approach
  • 1Password CLI now works correctly with service account tokens
  • Better documentation for both usage patterns

Testing

  • Template structure follows the official specification
  • Can be applied using Dev Container CLI
  • 1Password authentication tested with service account tokens

- Create src/polyglot-devcontainer/ directory with proper template structure
- Add devcontainer-template.json with template metadata and options
- Copy devcontainer configuration files to template directory
- Support both pre-built image and template distribution methods
- Update README to document both approaches (image vs template)

Additional improvements:
- Add 1Password domains to firewall allowlist for CLI authentication
- Fix empty environment variable issues with 1Password Connect
- Remove automatic service account creation in favor of manual setup
- Clean up Docker Compose environment variable handling

This makes the repository fully compliant with the Dev Container Template
specification while maintaining backward compatibility with direct image usage.
- Better reflects that this is the Liquescent Development container
- Update all references in documentation and metadata
- Remove outdated TEMPLATE_USAGE.md file
- Clean up accidentally created .devcontainer/src directory
- Create publish-templates.yml workflow to package and publish templates to OCI registry
- Add devcontainer-collection.json metadata file for template collection
- Copy missing template files (.env.example, allowed-domains.txt.example, .gitignore)
- Fix template option syntax in docker-compose.yml
- Update README with published template usage instructions

This enables users to reference the template directly from the registry:
ghcr.io/liquescent-development/templates/liquescent-devcontainer
@richardkiene richardkiene merged commit fe3709e into main Aug 23, 2025
1 check passed
@richardkiene richardkiene deleted the feature/devcontainer-template-compliance branch August 23, 2025 00:29
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.

2 participants