History

Asher 7868f4db23 Fix cross-compilation (#6441 ) * Avoid packaging yarn.lock Since the shrinkwrap is what we want everything to use. * Build with npm It seems we stuck with yarn because npm was giving us errors but I will try sorting it out now so we can build with npm as originally intended. * Remove build from source Not using CentOS 7 anymore so based on the comment we no longer need this. Keytar seems to install fine now. * Update missed Node version These numbers are all over the place. * npm_config_arch must be lowercase * Patch out Kerberos I am not sure exactly how it is used but I think it is not a path code-server worries about, at least not right now. Just going to patch it out rather than figure out how to build it on armv7l but we can revisit later.		2023-09-21 23:21:01 -08:00
..
build	Fix cross-compilation (#6441 )	2023-09-21 23:21:01 -08:00
dev	Fix watch script ignoring stdout	2023-02-08 11:42:28 -09:00
helm-chart	Add pod annotations (#6432 )	2023-09-16 00:31:05 +00:00
release-image	feat: add docker image release for Ubuntu based image (#5688 )	2022-10-24 18:41:19 +00:00
steps	refactor: get version dynamically (#5753 )	2022-11-08 22:45:01 +00:00
Caddyfile	feat(e2e): add support running behind proxy (#5348 )	2022-08-09 18:24:37 +00:00
README.md	fix: relative path in markdown (#6188 )	2023-05-08 12:38:52 -08:00
lib.sh	refactor: get version dynamically (#5753 )	2022-11-08 22:45:01 +00:00

README.md

ci

This directory contains scripts used for code-server's continuous integration infrastructure.

Some of these scripts contain more detailed documentation and options in header comments.

Any file or directory in this subdirectory should be documented here.

./ci/lib.sh
- Contains code duplicated across these scripts.

dev

This directory contains scripts used for the development of code-server.

./ci/dev/image
- See ./docs/CONTRIBUTING.md for docs on the development container.
./ci/dev/fmt.sh (yarn fmt)
- Runs formatters.
./ci/dev/lint.sh (yarn lint)
- Runs linters.
./ci/dev/test-unit.sh (yarn test:unit)
- Runs unit tests.
./ci/dev/test-e2e.sh (yarn test:e2e)
- Runs end-to-end tests.
./ci/dev/ci.sh (yarn ci)
- Runs yarn fmt, yarn lint and yarn test.
./ci/dev/watch.ts (yarn watch)
- Starts a process to build and launch code-server and restart on any code changes.
- Example usage in ./docs/CONTRIBUTING.md.
./ci/dev/gen_icons.sh (yarn icons)
- Generates the various icons from a single .svg favicon in src/browser/media/favicon.svg.
- Requires imagemagick

build

This directory contains the scripts used to build and release code-server. You can disable minification by setting MINIFY=.

./ci/build/build-code-server.sh (yarn build)
- Builds code-server into ./out and bundles the frontend into ./dist.
./ci/build/build-vscode.sh (yarn build:vscode)
- Builds vscode into ./lib/vscode/out-vscode.
./ci/build/build-release.sh (yarn release)
- Bundles the output of the above two scripts into a single node module at ./release.
./ci/build/clean.sh (yarn clean)
- Removes all build artifacts.
- Useful to do a clean build.
./ci/build/code-server.sh
- Copied into standalone releases to run code-server with the bundled node binary.
./ci/build/test-standalone-release.sh (yarn test:standalone-release)
- Ensures code-server in the ./release-standalone directory works by installing an extension.
./ci/build/build-packages.sh (yarn package)
- Packages ./release-standalone into a .tar.gz archive in ./release-packages.
- If on linux, nfpm is used to generate .deb and .rpm.
./ci/build/nfpm.yaml
- Used to configure nfpm to generate .deb and .rpm.
./ci/build/code-server-nfpm.sh
- Entrypoint script for code-server for .deb and .rpm.
./ci/build/code-server.service
- systemd user service packaged into the .deb and .rpm.
./ci/build/release-github-draft.sh (yarn release:github-draft)
- Uses gh to create a draft release with a template description.
./ci/build/release-github-assets.sh (yarn release:github-assets)
- Downloads the release-package artifacts for the current commit from CI.
- Uses gh to upload the artifacts to the release specified in package.json.
./ci/build/npm-postinstall.sh
- Post install script for the npm package.
- Bundled byyarn release.

release-image

This directory contains the release docker container image.

./ci/steps/build-docker-buildx-push.sh
- Builds the release containers with tags codercom/code-server-$ARCH:$VERSION for amd64 and arm64 with docker buildx and pushes them.
- Assumes debian releases are ready in ./release-packages.

images

This directory contains the images for CI.

steps

This directory contains the scripts used in CI. Helps avoid clobbering the CI configuration.

./steps/fmt.sh
- Runs yarn fmt.
./steps/lint.sh
- Runs yarn lint.
./steps/test-unit.sh
- Runs yarn test:unit.
./steps/test-integration.sh
- Runs yarn test:integration.
./steps/test-e2e.sh
- Runs yarn test:e2e.
./steps/release.sh
- Runs the release process.
- Generates the npm package at ./release.
./steps/release-packages.sh
- Takes the output of the previous script and generates a standalone release and release packages into ./release-packages.
./steps/publish-npm.sh
- Grabs the npm-package release artifact for the current commit and publishes it on npm.
./steps/docker-buildx-push.sh
- Builds the docker image and then pushes it.
./steps/push-docker-manifest.sh
- Loads all images in ./release-images and then builds and pushes a multi architecture docker manifest for the amd64 and arm64 images to codercom/code-server:$VERSION and codercom/code-server:latest.