honeymoose/angular-cn
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
angular-cn/aio/aio-builds-setup/docs/image-config--environment-variables.md
Georgios Kalpakas 8ae0eec230 feat(aio): enable previews for any PR 
This commit introduces the ability to show previews for PRs by any author. It works as follows:

- The build artifacts of all PRs are uploaded to the preview server.
- Automatically verified PRs (i.e. from trusted authors or having a specific label) are deployed and
  publicly accessible as usual.
- PRs that could not be automatically verified are stored for later use (after re-verification).
- A PR can be marked as "trusted" and make its preview publicly accessible by adding the GitHub
  label specified in the `AIO_TRUSTED_PR_LABEL` env var of the preview server.

At the moment, there is no automatic mechanism for notifying the preview server about changes to the
PR's verification status. The PR's "visibility" will be checked and updated every time a new build
is uploaded.
2017-06-23 11:54:20 -07:00

2.4 KiB
Raw Blame History

Image config - Environment variables

Below is a list of environment variables that can be configured when creating the docker image (as described here). An up-to-date list of the configurable environment variables and their default values can be found in the Dockerfile.

Note: Each variable has a TEST_ prefixed counterpart, which is used for testing purposes. In most cases you don't need to specify values for those.

  • AIO_BUILDS_DIR: The directory (inside the container) where the uploaded build artifacts are kept.

  • AIO_DOMAIN_NAME: The domain name of the server.

  • AIO_GITHUB_ORGANIZATION: The GitHub organization whose teams are whitelisted for accepting uploads. See also AIO_GITHUB_TEAM_SLUGS.

  • AIO_GITHUB_TEAM_SLUGS: A comma-separated list of teams, whose authors are allowed to upload PRs. See also AIO_GITHUB_ORGANIZATION.

  • AIO_NGINX_HOSTNAME: The internal hostname for accessing the nginx server. This is mostly used for performing a periodic health-check.

  • AIO_NGINX_PORT_HTTP: The port number on which nginx listens for HTTP connections. This should be mapped to the corresponding port on the host VM (as described here).

  • AIO_NGINX_PORT_HTTPS: The port number on which nginx listens for HTTPS connections. This should be mapped to the corresponding port on the host VM (as described here).

  • AIO_REPO_SLUG: The repository slug (in the form <user>/<repo>) for which PRs will be uploaded.

  • AIO_TRUSTED_PR_LABEL: The PR whose presence indicates the PR has been manually verified and is allowed to have its build artifacts publicly served. This is useful for enabling previews for any PR (not only those from trusted authors).

  • AIO_UPLOAD_HOSTNAME: The internal hostname for accessing the Node.js upload-server. This is used by nginx for delegating upload requests and also for performing a periodic health-check.

  • AIO_UPLOAD_MAX_SIZE: The maximum allowed size for the uploaded gzip archive containing the build artifacts. Files larger than this will be rejected.

  • AIO_UPLOAD_PORT: The port number on which the Node.js upload-server listens for HTTP connections. This is used by nginx for delegating upload requests and also for performing a periodic health-check.