Deployment - JustFixNYC/eviction-free-nyc GitHub Wiki

Eviction Free currently has two deployments:

• The development deployment is synced to the master branch and hosted at demo-efnyc.netlify.app.

• The production deployment is synced to the production branch and hosted at www.evictionfreenyc.org.

The front-end is deployed by Netlify when a deployment's respective branch is pushed to. Note that at present, this is not contingent on tests passing.

The following pages show the status of these deploys:

• Netlify development instance deploy status
• Netlify production instance deploy status

Deploying to development

Just issue a PR against the default master branch. Once the PR is merged, the development instance will be updated.

Deploying to production

Preferred method: fast-forward merge from master into production

The preferred way of deploying to production is to merge master into production via the command-line, which should result in a fast-forward. This is preferred to a formal GitHub PR because a PR would create a merge commit, which would then require merging back into master, which is a hassle.

This can be done via e.g.:

git checkout production
git merge master --ff-only
git push

Alternative method: pull request from master into production

However, if the person making the deployment doesn't have permission to push directly to production, they can do so via a pull request from master into production. Just make sure to merge the PR using a merge commit (do not squash or rebase, as this will result in very different histories for the two branches, making future merges confusing).

Once the PR is merged, production should be merged back into master to ensure that both branches are in-sync.

Fallback method: deploying directly from the command-line

If CircleCI or GitHub is down, a deployment can be made by using the Heroku and Netlify CLIs directly from the command-line. This requires setting up the Heroku and Netlify CLIs and is generally discouraged.