theia-code-os/packages/dev-container/README.md

ECLIPSE THEIA - DEV-CONTAINER EXTENSION

---

Description

The @theia/dev-container extension provides functionality to create, start and connect to development containers similiar to the vscode Dev Containers extension.

The full devcontainer.json Schema can be found here. Currently not all of the configuration file properties are implemented. The following are implemented:

• name
• Image
• dockerfile/build.dockerfile
• build.context
• location
• forwardPorts
• mounts
• containerEnv
• remoteUser
• shutdownAction
• postCreateCommand
• postStartCommand

see main-container-creation-contributions.ts for how to implementations or how to implement additional ones.

Additionally adds support for composeUpArgs devcontainer.json property to apply additional arguments for the docker compose up call. Usage: "composeUpArgs": ["--force-recreate"]

Additional Information

• API documentation for @theia/dev-container
• Theia - GitHub
• Theia - Website

License

• Eclipse Public License 2.0
• 一 (Secondary) GNU General Public License, version 2 with the GNU Classpath Exception

Trademark

"Theia" is a trademark of the Eclipse Foundation https://www.eclipse.org/theia