README.md
1Integrations
2============
3
4This repository contains `Dockerfile`s that describe how to build open source projects (usually those with complex build tasks) with a specific version of typescript. These are used for extended validations of a given typescript build.
5
6Contributing
7-----------
8
9To add a new test:
10* Create a new folder with the name of the project
11* Create a `Dockerfile` within that folder
12* The `Dockerfile` will be built with `docker build . -t tstest/folder` and then run with `docker run tstest/folder`
13* Write the dockerfile such that it can build the target project and injects the typescript package from the `typescript/typescript` image (which should have a tar file at `/typescript/typescript-*.tgz`)
14
15Debugging
16---------
17
18You can open a test's container with an interactive shell to debug with `docker run -it --entrypoint "/bin/sh" tstest/folder`.
19If you want to remote debug a typescript process within a container, you'll need to forward the port you instruct the
20compiler or language server to listen on by passing `--expose PORT` where `PORT` is the port number you'd like forwarded to the
21host.
22