.. | ||
build | ||
container | ||
dev | ||
release-container | ||
steps | ||
lib.sh | ||
README.md |
ci
This directory contains scripts used for code-server's continuous integration infrastructure.
Many of these scripts contain more detailed documentation and options in comments at the top.
Any file and directory added into this tree should be documented here.
Publishing a release
Make sure you have $GITHUB_TOKEN
set and hub installed.
- Update the version of code-server in
package.json
and push a commit - GitHub actions will generate the
npm-package
andrelease-packages
artifacts - Run
yarn release:github-draft
to create a GitHub draft release from the template with the updated version.- Summarize the major changes in the release notes and link to the relevant issues.
- Wait for the artifacts in step 2 to build
- Run
yarn release:github-assets
to download the artifacts and then upload them to the draft release - Run some basic sanity tests on one of the released packages
- Publish the release
- CI will automatically grab the artifacts and then
- Publish the NPM package
- Publish the AMD64 docker image
- Publish the ARM64 docker image
- CI will automatically grab the artifacts and then
dev
This directory contains scripts used for the development of code-server.
- ./dev/container
- See CONTRIBUTING.md for docs on the development container
- ./dev/ci.sh (
yarn ci
)- Runs formatters, linters and tests
- ./dev/fmt.sh (
yarn fmt
)- Runs formatters
- ./dev/lint.sh (
yarn lint
)- Runs linters
- ./dev/test.sh (
yarn test
)- Runs tests
- ./dev/vscode.sh (
yarn vscode
)- Ensures
lib/vscode
is cloned, patched and dependencies are installed
- Ensures
- ./dev/vscode.patch
- Our patch of VS Code to enable remote browser access
- Generate it with
yarn vscode:diff
and apply withyarn vscode:patch
- ./dev/watch.ts (
yarn watch
)- Starts a process to build and launch code-server and restart on any code changes
- Example usage in CONTRIBUTING.md
build
This directory contains the scripts used to build and release code-server.
You can disable minification by setting MINIFY=
.
- ./lib.sh
- Contains code duplicated across these scripts.
- ./build/build-code-server.sh (
yarn build
)- Builds code-server into ./out and bundles the frontend into ./dist.
- ./build/build-vscode.sh (
yarn build:vscode
)- Builds vscode into ./lib/vscode/out-vscode.
- ./build/build-release.sh (
yarn release
)- Bundles the output of the above two scripts into a single node module at
./release
.
- Bundles the output of the above two scripts into a single node module at
- ./build/build-static-release.sh (
yarn release:static
)- Requires a release already built in
./release
. - Will build a static release with node and node_modules into
./release-static
- Requires a release already built in
- ./build/clean.sh (
yarn clean
)- Removes all git ignored files like build artifacts.
- Will also
git reset --hard lib/vscode
- Useful to do a clean build.
- ./build/code-server.sh
- Copied into static releases to run code-server with the bundled node binary.
- ./build/test-static-release.sh (
yarn test:static-release
)- Ensures code-server in the
./release-static
directory runs
- Ensures code-server in the
- ./build/build-packages.sh (
yarn package
)- Packages
./release-static
into an archive in./release-packages
- If on linux, nfpm is used to generate .deb and .rpm
- Packages
- ./build/nfpm.yaml
- Used to configure nfpm to generate .deb and .rpm
- ./build/code-server-nfpm.sh
- Entrypoint script for code-server for .deb and .rpm
- ./build/code-server.service
- systemd user service packaged into the debs and rpms
- ./build/release-github-draft.sh (
yarn release:github-draft
)- Uses hub to create a draft release with a template description
- ./build/release-github-assets.sh (
yarn release:github-assets
)- Downloads the release-package artifacts for the current commit from CI
- Uses hub to upload the artifacts to the release
specified in
package.json
release-container
This directory contains the release docker container.
- ./release-container/build.sh
- Builds the release container
- Assumes debian releases are ready in
./release-packages
- ./release-container/push.sh
- Pushes the built release container to docker hub and updates the latest tag
container
This directory contains the container for CI.
steps
This directory contains a few scripts used in CI. Just helps avoid clobbering the CI configuration.
- ./steps/test.sh
- Runs
yarn ci
after ensuring VS Code is patched
- Runs
- ./steps/release.sh
- Runs the full release process
- Generates the npm package at
./release
- ./steps/static-release.sh
- Takes the output of the previous script and generates a static release and packages
- ./steps/lib.sh
- Contains helpers to download artifacts from github actions workflow runs
- ./steps/publish-npm.sh
- Grabs the
npm-package
release artifact for the current commit and publishes it on NPM
- Grabs the
- ./steps/publish-docker.sh
- Grabs the
release-packages
release artifact for the current commit and builds a docker image with it and publishes that onto docker hub with the correct tag and updates latest
- Grabs the