Create and develop cloud-native, containerized web applications from VS Code.
You can install Codewind locally in VS Code. For more information about installing Codewind, see Installing Codewind for VS Code.
Prerequisites
- Install VS Code.
- Install Docker.
- If you use Linux, you also need to install Docker Compose.
Complete the installation:
- Find Codewind for VS Code in the VS Code Marketplace or by searching for
Codewind
in the VS Code Extensions view. - Open the Codewind view in the Explorer view group or enter
Focus on Codewind View
into the Command Palette. If you do not see the Codewind view in either the Explorer view or the Command Palette, the extension did not install correctly. - Codewind requires the installation of additional Docker images to run. Choose Install when prompted to complete the installation. The installation may take a few minutes to complete. Codewind creates a folder called
codewind-workspace
within your home directory to contain your projects. On Windows, this is theC:\codewind-workspace
directory. When the installation is complete, you can open thecodewind-workspace
folder or a project within the workspace as your VS Code workspace. The tools offer to open the workspace for you if it’s not open already.
To see the actions available, open the Command Palette and type Codewind
.
Features:
- Create New Project and Add Existing Project: Create new projects from application templates or import existing container-ready projects.
- Codewind view: View Codewind projects, including application and build statuses.
- Attach debugger: Debug Microprofile, Spring, and Node.js projects in their containers.
- Show all logs: View application and build logs in the VS Code Output view.
- Open folder as workspace: View and edit project deployment information.
- Open container shell: Open a shell session into a Codewind application container.
- Toggle auto build: Toggle project auto build and manually initiate project builds.
- Enable or disable project and Show project overview: Disable, enable, and delete projects.
Submit issues and contributions:
- To host the extension yourself so you can develop or debug it, clone this repository and run the Extension launch in
dev/.vscode/launch.json
. See Developing Extensions for more information. - If not run using the Extension launch, the tools will pull the latest Codewind release tag, eg.
0.3
(seeDEFAULT_CW_TAG
). To run against the latest development version of Codewind: - You can also build the extension
.vsix
yourself by runningvsce package
fromdev/
. Refer to theJenkinsfile
to see the exact steps the build runs. - The
prebuild
script is used in the CI builds to build separate versions of the extension for VS Code and Theia, since each of those has some commands that the other does not. It deletes inapplicable commands from thepackage.json
, and does not modify any ts/js code. Run this beforevsce package
to get a closer-to-production build, but be ready to revert the changes.