fix installation instructions

This commit is contained in:
Julien Fastré 2020-04-22 13:09:26 +02:00
parent 79b9f0d274
commit 2b63c51dee

View File

@ -11,8 +11,8 @@
A copy of the license is included in the section entitled "GNU
Free Documentation License".
Installation
#############
Installation & Usage
####################
Requirements
@ -22,10 +22,10 @@ Requirements
- Make is used to automate scripts.
Installation in development mode
*******************************
********************************
Get the code
============
1. Get the code
===============
Clone or download the chill-standard project and `cd` into the main directory.
@ -36,11 +36,10 @@ Clone or download the chill-standard project and `cd` into the main directory.
cd Chill-Standard
As a developer, the code will stay on your computer and will be executed in docker container. To avoid permission problem, the code should be run with the same uid/gid from your current user. This is why we get your current user id with the command ``id -u`` in each following scripts.
Prepare your variables
======================
2. Prepare your variables
=========================
Have a look at the variable in ``env.dist`` and in ``app/config/parameters.yml.dist`` and check if you need to adapt them. If they do not adapt with your need, or if some are missing:
@ -51,8 +50,8 @@ Have a look at the variable in ``env.dist`` and in ``app/config/parameters.yml.d
**Note**: If you intend to use the bundle ``Chill-Doc-Store``, you will need to configure and install an openstack object storage container with temporary url middleware. You will have to configure `secret keys <https://docs.openstack.org/swift/latest/api/temporary_url_middleware.html#secret-keys>`_.
Run the bootstrap script
========================
3. Run the bootstrap script
===========================
This script can be run using `make`
@ -65,18 +64,11 @@ This script will :
1. force docker-compose to, eventually, pull the base images and build the image used by this project ;
2. run an install script to download `composer <https://getcomposer.org>`_ ;
3. install the php dependencies
4. build assets
Build assets
============
run those commands:
.. code-block:: bash
make build-assets
Start the project
=================
4. Start the project
====================
.. code-block:: bash
@ -86,7 +78,7 @@ Start the project
.. code-block:: bash
docker-compose exec --user $(id -u) php app/console doctrine:migrations:migrate
make migrate
Chill will be available at ``http://localhost:8001.`` Currently, there isn't any user or data. To add fixtures, run
@ -101,11 +93,20 @@ There are several users available:
The password is always ``password``.
Now, read the how-tos.
Now, read `Operations` below.
Operations
**********
Build assets
============
run those commands:
.. code-block:: bash
make build-assets
How to execute the console ?
============================