You can find the example project on[GitHub](https://github.com/codefresh-contrib/heroku-python-django-sample-app).

You can find the example project on[GitHub](https://github.com/codefresh-contrib/heroku-python-django-sample-app){:target="\_blank"}.

The repository contains a Django starter project with the following commands:

- A[freeCodefresh account]({{site.baseurl}}/docs/administration/account-user-management/#create-a-codefresh-account/)

- A[Codefresh account]({{site.baseurl}}/docs/administration/account-user-management/create-codefresh-account/)

- A[free Heroku account](https://signup.heroku.com){:target="\_blank"}

- A Heroku API token (you can find this under**Account Settings** and then scrolling down, you will find the API Key)

You should be able to copy and paste this YAML in the in-line editor of the Codefresh UI. It will automatically clone the project for you.

Note that you need to change the environment variables in the deploy stage to your respective values. You can do thisdirectly[in the YAML itself]({{site.baseurl}}/docs/how-to-guides/migrating-from-travis-ci/#environment-variables), orthrough the Codefresh UI. Navigate to the in-line editor, and to the right you will find a tablebeled**Variables**.

Note that you need to change the environment variables in the deploy stage to your respective values. You can do this through the Codefresh UI. Navigate to the in-line editor, and to the right you will find a tablabeled**Variables**.

{% include image.html

lightbox="true"

1. A[git-clone]({{site.baseurl}}/docs/pipelines/steps/git-clone/) step that clones the main repository

2. A[freestyle step]({{site.baseurl}}/docs/pipelines/steps/freestyle/) that installs dependencies and runs the unit tests

3. A freestyle step that deploys the application to Heroku using the heroku-deployer plugin from the[Step Marketplace](https://codefresh.io/steps/step/heroku-deployer)

3. A freestyle step that deploys the application to Heroku using the heroku-deployer plugin from the[Step Marketplace](https://codefresh.io/steps/step/heroku-deployer){:target="\_blank"}.

This example differs from the plugin usage, as it deploys a built Docker image to Heroku.

Note that you need to change the environment variables to your respective values. You can do thisdirectly[in the YAML itself]({{site.baseurl}}/docs/how-to-guides/migrating-from-travis-ci/#environment-variables), orthrough the Codefresh UI. Navigate to the in-line editor, and to the right you will find a tablebeled**Variables**.

Note that you need to change the environment variables to your respective values. You can do this through the Codefresh UI. Navigate to the in-line editor, and to the right you will find a tablabeled**Variables**.

{% include image.html

lightbox="true"

- A[freeCodefresh account]({{site.baseurl}}/docs/administration/account-user-management/#create-a-codefresh-account/)

- A[Codefresh account]({{site.baseurl}}/docs/administration/account-user-management/create-codefresh-account/)

- A[free Heroku account](https://signup.heroku.com){:target="\_blank"}

- An empty repository already created in Heroku using the`heroku create <IMAGE_NAME>` command

- A Heroku registry[connected to Codefresh]({{site.baseurl}}/docs/docker-registries/external-docker-registries/other-registries/#heroku-registries)

- A Heroku registry[connected to Codefresh]({{site.baseurl}}/docs/integrations/docker-registries/other-registries/#heroku-registries)

- A Heroku API token (you can find this under**Account Settings** and then scrolling down, you will find the API Key)

[CI/CD pipeline examples]({{site.baseurl}}/docs/example-catalog/examples/#cd-examples)

[CD pipeline examples]({{site.baseurl}}/docs/example-catalog/examples/#cd-examples)

toc:true

[Kustomize](https://kustomize.io) is a tool included with kubectl 1.14 that "lets you customize raw, template-free YAML files for multiple purposes, leaving the original YAML untouched and usable as is."

[Kustomize](https://kustomize.io){:target="\_blank"} is a tool included with kubectl 1.14 that "lets you customize raw, template-free YAML files for multiple purposes, leaving the original YAML untouched and usable as is."

Kustomize is more of an overlay engine, as opposed to a templating engine. You create a base configuration and overlays. Your overlays contain a*kustomization.yaml* file, and any variants/changes are applied over top of the base configuration. Kustomize does not use templates at all.

mysqlDB: "prod-mysql.example.com:3306"

```

In addition, for the production environment, the number of replicas will be overlayed to 3 instead of1 (as [definedinthebasedeployment](https://github.com/codefresh-contrib/kustomize-sample-app/blob/32e683f82940de0bf2de2da40fa6b150e2b24b23/base/deployment.yaml#L8)){:target="\_blank"}.

In addition, for the production environment, the number of replicas will be overlayed to 3 instead of1 (as [definedinthebasedeployment](https://github.com/codefresh-contrib/kustomize-sample-app/blob/32e683f82940de0bf2de2da40fa6b150e2b24b23/base/deployment.yaml#L8){:target="\_blank"}).

`overlays/production/deployment.yaml`

```yaml

##Prerequisites

-A [freeCodefreshaccount]({{site.baseurl}}/docs/administration/account-user-management/create-codefresh-account)

- A Kubernetes cluster [connected to your Codefresh account](https://codefresh.io/docs/docs/integrations/kubernetes/#connect-a-kubernetes-cluster)

-A [freeCodefreshaccount]({{site.baseurl}}/docs/administration/account-user-management/create-codefresh-account/)

- A Kubernetes cluster [connected to your Codefresh account]({{site.baseurl}}/docs/integrations/kubernetes/#connect-a-kubernetes-cluster)

##Create the staging environment pipeline

##Related articles

[CI/CD pipeline examples]({{site.baseurl}}/docs/example-catalog/examples/#cd-examples)

[Deployment optionstoKubernetes]({{site.baseurl}}/docs/deployments/kubernetes/deployment-options-to-kubernetes)

[CD pipeline examples]({{site.baseurl}}/docs/example-catalog/examples/#cd-examples)

[Deployment optionsforKubernetes]({{site.baseurl}}/docs/deployments/kubernetes/deployment-options-to-kubernetes)

[Running custom kubectl commands]({{site.baseurl}}/docs/deployments/kubernetes/custom-kubectl-commands/)

[Deploy withHelm]({{site.baseurl}}/docs/example-catalog/cd-examples/helm/)

{% include image.html

lightbox="true"

file="/images/2f1884a-codefresh_env_vars.png"

url="/images/2f1884a-codefresh_env_vars.png"

file="/images/examples/docker-swarm/codefresh_env_vars.png"

url="/images/examples/docker-swarm/codefresh_env_vars.png"

alt="Docker Swarm build parameters"

caption="Docker Swarm build parameters"

max-width="70%"

{% endraw %}

{% endhighlight %}

The values of`MY_REGISTRY`,`MY_REGISTRY_USER` and`MY_REGISTRY_PASSWORD` depend upon the type of[your connected registry]({{site.baseurl}}/docs/integration/docker-registries/).

The values of`MY_REGISTRY`,`MY_REGISTRY_USER` and`MY_REGISTRY_PASSWORD` depend upon the type of[your connected registry]({{site.baseurl}}/docs/integrations/docker-registries/).

[CI/CD pipeline examples]({{site.baseurl}}/docs/example-catalog/examples/#cd-examples)

[CD pipeline examples]({{site.baseurl}}/docs/example-catalog/examples/#cd-examples)

[Codefresh YAML for pipeline definitions]({{site.baseurl}}/docs/pipelines/what-is-the-codefresh-yaml/)

[Steps in pipelines]({{site.baseurl}}/docs/pipelines/steps/)

[Creating pipelines]({{site.baseurl}}/docs/pipelines/pipelines/)

Codefresh has comprehensive support for Helm:

* Free[built-in Helm repository]({{site.baseurl}}/docs/deployments/helm/managed-helm-repository/) with each Codefresh account

*[Helm chart dashboard]({{site.baseurl}}/docs/docs/deployments/add-helm-repository/) to track your charts

*[Helm Release dashboard]({{site.baseurl}}/docs/docs/deployments/helm-releases-management/) to view your deployments

*[Helm chart dashboard]({{site.baseurl}}/docs/deployments/helm/helm-charts-and-repositories/) to track your charts

*[Helm Release dashboard]({{site.baseurl}}/docs/deployments/helm/helm-releases-management/) to view your deployments

*[Environment dashsboard]({{site.baseurl}}/docs/deployments/kubernetes/environment-dashboard/) to view Helm releases

*[Helm promotion dashboard]({{site.baseurl}}/docs/deployments/helm-environment-promotion/) to promote Helm releases

*[Helm promotion dashboard]({{site.baseurl}}/docs/deployments/helm/helm-environment-promotion/) to promote Helm releases

* Add any external Helm repository on any other cloud provider

Codefresh also provides a[pipeline step]({{site.baseurl}}/docs/new-helm/using-helm-in-codefresh-pipeline/) for deploying with Helm.

Codefresh also provides a[pipeline step]({{site.baseurl}}/docs/deployments/helm/using-helm-in-codefresh-pipeline/) for deploying with Helm.

For more insights on Helm charts see also our[Helm best practices]({{site.baseurl}}/docs/new-helm/helm-best-practices/) guide.

For more insights on Helm charts see also our[Helm best practices]({{site.baseurl}}/docs/ci-cd-guides/helm-best-practices/) guide.

You can see the example project at[https://github.com/codefresh-contrib/helm-sample-app](https://github.com/codefresh-contrib/helm-sample-app){:target=\_blank"}. The repository contains a simple Go application, a Dockerfile and an example chart.

You can see the example project at[https://github.com/codefresh-contrib/helm-sample-app](https://github.com/codefresh-contrib/helm-sample-app){:target="\_blank"}. The repository contains a simple Go application, a Dockerfile and an example chart.

[At least one Kubernetes cluster]({{site.baseurl}}/docs/integrations/kubernetes/#connect-a-kubernetes-cluster/) in your Codefresh account.

[At least one Kubernetes cluster]({{site.baseurl}}/docs/integrations/kubernetes/#connect-a-kubernetes-cluster) in your Codefresh account.

1. Clones the source code through a[Git clone step]({{site.baseurl}}/docs/pipelines/steps/git-clone/)

1. Builds a docker image through a[build step]({{site.baseurl}}/docs/pipelines/steps/build/)

1. Deploys the Helm chart to a cluster named`my-demo-k8s-cluster` using the Helm step[from the Step Marketplace](https://codefresh.io/steps/step/helm){:target=\_blank"}.

1. Deploys the Helm chart to a cluster named`my-demo-k8s-cluster` using the Helm step[from the Step Marketplace](https://codefresh.io/steps/step/helm){:target="\_blank"}.

In this example,`charts/helm-example` refers to the[filesystem location in the code](https://github.com/codefresh-contrib/helm-sample-app/tree/master/charts/helm-example){:target=\_blank"} that was just checked out.

In this example,`charts/helm-example` refers to the[filesystem location in the code](https://github.com/codefresh-contrib/helm-sample-app/tree/master/charts/helm-example){:target="\_blank"} that was just checked out.

The deployment will be visible in the[Helm releases dashboard]({{site.baseurl}}/docs/new-helm/helm-releases-management/).

The deployment will be visible in the[Helm releases dashboard]({{site.baseurl}}/docs/deployments/helm/helm-releases-management/).

{% include image.html

lightbox="true"

It is recommended to use a Helm repository to store your chart before deploying it. This way you know what is deployed in your clusters

and you can also reuse charts in other installations.

First of all you need to import in your pipeline from the[shared configuration]({{site.baseurl}}/docs/pipelines/shared-configuration/) the settings for the internal Helm repository (or any other external repository that you have setup in Codefresh).

First of all you need to import in your pipeline from the[shared configuration]({{site.baseurl}}/docs/pipelines/configuration/shared-configuration/) the settings for the internal Helm repository (or any other external repository that you have setup in Codefresh).

This will make available the internal Helm repository to your pipeline so that it can push/pull Helm charts from it.

{% include image.html

{% endhighlight %}

After you finish running your pipeline, not only the deployment will take place, but you will also see your chart in your[Helm Chart dashboard]({{site.baseurl}}/docs/new-helm/add-helm-repository/):

After you finish running your pipeline, not only the deployment will take place, but you will also see your chart in your[Helm Chart dashboard]({{site.baseurl}}/docs/deployments/helm/helm-charts-and-repositories/):

{% include image.html

lightbox="true"

[CI/CD pipeline examples]({{site.baseurl}}/docs/example-catalog/examples/#cd-examples)

[CD pipeline examples]({{site.baseurl}}/docs/example-catalog/examples/#cd-examples)

[Codefresh YAML for pipeline definitions]({{site.baseurl}}/docs/pipelines/what-is-the-codefresh-yaml/)

[Steps in pipelines]({{site.baseurl}}/docs/pipelines/steps/)

[Creating pipelines]({{site.baseurl}}/docs/pipelines/pipelines/)

Even though Codefresh has great support for Kubernetes and Helm deployments, there is no lock-in on using just Kubernetes. Codefresh can deploy on any infrastructure.

[Nomad](https://www.nomadproject.io/){:target=\_blank"} is an alternative scheduling platform from Hashicorp. It supports docker containers (like Kubernetes), but you can also use Nomad to schedule VMs, Java apps, Go apps or any other standalone executable.

[Nomad](https://www.nomadproject.io/){:target="\_blank"} is an alternative scheduling platform from Hashicorp. It supports docker containers (like Kubernetes), but you can also use Nomad to schedule VMs, Java apps, Go apps or any other standalone executable.

There are several public Docker Images with Nomad, so it is very easy to use Codefresh pipelines to deploy to a Nomad cluster.

max-width="80%"

%}

In this example, we will use the image at[https://hub.docker.com/r/djenriquez/nomad](https://hub.docker.com/r/djenriquez/nomad){:target=\_blank"}.

In this example, we will use the image at[https://hub.docker.com/r/djenriquez/nomad](https://hub.docker.com/r/djenriquez/nomad){:target="\_blank"}.

You can see the example project at[https://github.com/codefresh-contrib/nomad-sample-app](https://github.com/codefresh-contrib/nomad-sample-app){:target=\_blank"}. The repository contains a simple job specification that deploys a docker container on nomad cluster.

You can see the example project at[https://github.com/codefresh-contrib/nomad-sample-app](https://github.com/codefresh-contrib/nomad-sample-app){:target="\_blank"}. The repository contains a simple job specification that deploys a docker container on nomad cluster.

Here is the whole job file:

{% endraw %}

{% endhighlight %}

Notice that the job specification has several[Codefresh variables]({{site.baseurl}}/docs/pipelines/variables/) embedded. We will use[envsubst](https://www.gnu.org/software/gettext/manual/html_node/envsubst-Invocation.html){:target=\_blank"} in our pipeline to replace

Notice that the job specification has several[Codefresh variables]({{site.baseurl}}/docs/pipelines/variables/) embedded. We will use[envsubst](https://www.gnu.org/software/gettext/manual/html_node/envsubst-Invocation.html){:target="\_blank"} in our pipeline to replace

them with the correct values.

You need to create a Codefresh account and have a Nomad cluster running. You need to decide on how Codefresh will communicate

with the nomad cluster. In this simple example we just use the`NOMAD_ADDR` variable to point the nomad client to our cluster. In a production environment you should use proper[ACL](https://www.nomadproject.io/guides/security/acl.html){:target=\_blank"} and[certificate](https://www.nomadproject.io/guides/security/securing-nomad.html){:target=\_blank"} variables as well.

with the nomad cluster. In this simple example we just use the`NOMAD_ADDR` variable to point the nomad client to our cluster. In a production environment you should use proper[ACL](https://www.nomadproject.io/guides/security/acl.html){:target="\_blank"} and[certificate](https://www.nomadproject.io/guides/security/securing-nomad.html){:target="\_blank"} variables as well.

In this example the Nomad cluster is already setup on a VM at Google cloud.

You can also use[Terraform]({{site.baseurl}}/docs/example-catalog/cd-examples/terraform/) in Codefresh pipelines.

[CI/CD pipeline examples]({{site.baseurl}}/docs/example-catalog/examples/#cd-examples)

[CD pipeline examples]({{site.baseurl}}/docs/example-catalog/examples/#cd-examples)

[Codefresh YAML for pipeline definitions]({{site.baseurl}}/docs/pipelines/what-is-the-codefresh-yaml/)

[Creating pipelines]({{site.baseurl}}/docs/pipelines/pipelines/)

[How Codefresh pipelines work]({{site.baseurl}}/docs/pipelines/introduction-to-codefresh-pipelines/)