We highly recommend the use of Preview Environments to get early feedback on changes to applications before the changes are merged into master.
Typically the creation of preview environments is automated inside the Pipelines created by Jenkins X.
What happens when a Preview environment is created
- a new Environment of kind
Previewis created along with a kubernetes namespace which shows up in the jx get environments command along with the jx environment and jx namespace commands so you can see which preview environments are active and switch into them to look around
- the Pull Request is built as a preview docker image and chart and deployed into the preview environment
- a comment is added to the Pull Request to let your team know the preview application is ready for testing with a link to open the application. So in one click your team members can try out the preview!
Adding more resources
Its common when creating, for example, a web front end to need a backend or database to work from to verify that the microservice works.
For each application the preview environment is defined by a helm chart at:
So you can easily add any dependent helm charts to your preview environment by adding new entries in the file
You can find possible charts to install by searching helm. e.g. to find a
postgresql chart try:
helm search postgres
Once you know the chart and the repository its in you can add it to your
charts/preview/requirements.yaml file (the
postgresql section in dependencies array):
# !! File must end with empty line !! dependencies: - alias: expose name: exposecontroller repository: http://chartmuseum.jenkins-x.io version: 2.3.56 - alias: cleanup name: exposecontroller repository: http://chartmuseum.jenkins-x.io version: 2.3.56 # Ephemeral PostgeSQL created in preview environment. - name: postgresql repository: https://kubernetes-charts.storage.googleapis.com version: 2.6.2 # !! "alias: preview" must be last entry in dependencies array !! # !! Place custom dependencies above !! - alias: preview name: demo179 repository: file://../demo179
- alias: preview must be last entry in dependecies array and
requirements.yaml file must end with empty line.
If you need any additional resources like
Service resources you can add them to
You can always service link from the Preview Environment namespace to other namespaces by creating a
Service with an
externalName which links to a
Service running in another namespace (such as Staging or Production) or to point to a service running outside of the Kubernetes cluster completely.
We have a command jx step service link which does this for you:
jx step link services --from-namespace jx-staging --includes "*" --excludes "cheese*"
If you need to tweak your application when running in a Preview Environment you can add custom settings to the
Post preview jobs
One of the extension points of Jenkins X lets you put a hook in after a preview job has been deployed. This hook applies to all apps in a team even existing ones, for all new pull requests/changes. (You don’t have to add it to each pipeline by hand - it can be used to enforce best practices).
This means you can run a container Job against the preview app, validating it, before the CI pipeline completes. Should this Job fail, the pull request will be marked as a failure.
Here is an example:
jx create post preview job --name owasp --image owasp/zap2docker-weekly:latest -c "zap-baseline.py" -c "-I" -c "-t" -c "\$(JX_PREVIEW_URL)"
This creates a post preview job which runs the
zap-baseline.py command inside the specified docker image (it will pull the image and run it, and then shut it down) which scans the running preview app for any problems.
$JX_PREVIEW_URL environment variable is made available in case the job needs to access the running preview app. Use
-c to pass commands to the container.
This job runs after the preview has been deployed. If it returns non zero, the PR will be marked as a failure.
You can also run:
jx get post preview
to list any configured post preview jobs, and:
jx delete post preview job --name=NAME_HERE
And it will remove that post preview job (for the whole team).
To get more detail on using preview environments check out this blog post
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.