Skip to content

[Heroku] A few more tweaks to outline the steps #4601

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Mar 15, 2015
Merged

[Heroku] A few more tweaks to outline the steps #4601

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
4ee7cef
A few more tweaks to outline the steps
weaverryan Dec 6, 2014
8c7e3b2
Changing to #. format
weaverryan Mar 15, 2015
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 22 additions & 11 deletions cookbook/deployment/heroku.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,14 +69,21 @@ You are now ready to deploy the application as explained in the next section.
Deploying your Application on Heroku
------------------------------------

To deploy your application to Heroku, you must first create a ``Procfile``,
which tells Heroku what command to use to launch the web server with the
correct document root. After that, you will ensure that your Symfony application
runs the ``prod`` environment, and then you'll be ready to ``git push`` to
Heroku for your first deploy!
Before your first deploy, you need to do just 2 more things, which are explained
below:

Creating a Procfile
~~~~~~~~~~~~~~~~~~~
1. :ref:`Create a Procfile <heroku-procfile>`

2. :ref:`Set the Environment to prod <heroku-setting-env-to-prod>`

Then you'll be ready for the last step:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't like this comment. Since this is a step-by-step section, it's very clear already that you have to do (1) and (2) before doing (3). When ommitting this, you can also use the very nice #. list :)


3. :ref:`Push your Code to Heroku <heroku-push-code>`

.. _heroku-procfile:

1) Create a Procfile
~~~~~~~~~~~~~~~~~~~~

By default, Heroku will launch an Apache web server together with PHP to serve
applications. However, two special circumstances apply to Symfony applications:
Expand Down Expand Up @@ -111,8 +118,10 @@ create the ``Procfile`` file and to add it to the repository:
[master 35075db] Procfile for Apache and PHP
1 file changed, 1 insertion(+)

Setting the ``prod`` Environment
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. _heroku-setting-env-to-prod:

2) Set the Environment to prod
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

During a deploy, Heroku runs ``composer install --no-dev`` to install all of the
dependencies your application requires. However, typical `post-install-commands`_
Expand All @@ -132,8 +141,10 @@ variables, you can issue a single command to prepare your app for a deployment:

$ heroku config:set SYMFONY_ENV=prod

Pushing to Heroku
~~~~~~~~~~~~~~~~~
.. _heroku-push-code:

3) Push your Code to Heroku
~~~~~~~~~~~~~~~~~~~~~~~~~~~

Next up, it's finally time to deploy your application to Heroku. If you are
doing this for the very first time, you may see a message such as the following:
Expand Down