Pointivo Action: Build

One build script to rule them all.

Sample: Dockerfile TEMPLATE

Environment Variables

Required:

• IMAGE_NAME
  • The name for the IMAGE when uploaded to the container registry. (Eg. core-api)
• CACHED_STAGES (Default: tooling,runtime,dependencies)
  • A comma seperated list of build stage (target) within your Dockerfile that can be cached between builds.
• TEST_PATH
  • The location of the unit tests files after build. This path should be relative to the build container image.
• BUILD_STATUS_PATH
  • The location of the build_status file which the Docker build stage produces (to declare if the build was successful or not). This path should be relative to the build container image.

Optional:

• PULL_IMAGES (Default: None)
  • A comma seperated list of images to docker pull (to get latest) before building. Eg. ubuntu:latest,node:lts
• RELEASE_STAGE (Default: $IMAGE_NAME)
  • The Docker stage which builds the final container.
• BUILD_STAGE (Default: build)
  • An alternative build stage name (for mono-repos).
• EXTRA_BUILD_ARGS (Default: None)
  • These are extra arguments that you will be passed to docker build. Eg Gradle Build args --build arg gradleTarget=...
• DOCKERFILE_DIRECTORY (Default: ./)
  • Use this if (in a monorepo) you have multiple docker files and there is a sub-directory where your Dockerfile is located.
• DOCKERFILE_NAME (Default: Dockerfile)
  • Use this if you use a different Docker file name.
• ARTIFACT_PATHS (Default: /test-results,/reports,/build_status)
  • A comma seperated list of files or directories which need to be exported as an artifact.
• SOURCE_MAP_PATH
  • A directory containing source maps which are exported as an artifact.
• RELEASE_TAG (Default: snapshot)
  • Override: This is used to specify the prerelease section of a full SEMVER which we tag our container images. Use depending on where the final output image will be deployed. snapshot implies master, prerelease implies qa, release` implies production.
• SEMVER
  • Override: This is, by default, grabbed from a file called version.sh in the root directory of the repository.