mirror of
https://gitlab.com/Chill-Projet/chill-bundles.git
synced 2025-06-07 18:44:08 +00:00
102 lines
2.5 KiB
ReStructuredText
102 lines
2.5 KiB
ReStructuredText
.. _installation-for-dev:
|
|
|
|
Installation for development or testing purpose only
|
|
====================================================
|
|
|
|
⚠️ Use this method for development only. ⚠️
|
|
|
|
You will need:
|
|
|
|
- `Composer <https://getcomposer.org>`__;
|
|
- `Symfony-cli tool <https://symfony.com/download>`__;
|
|
- `docker <https://docs.docker.com/engine/install/>`__ and
|
|
`docker-compose <https://docs.docker.com/compose/>`__
|
|
- node > 20 and yarn 1.22
|
|
|
|
First initialization
|
|
--------------------
|
|
|
|
1. clone the repository and move to the cloned directory:
|
|
|
|
.. code:: bash
|
|
|
|
git clone https://gitlab.com/Chill-Projet/chill-bundles.git
|
|
cd chill-bundles
|
|
|
|
2. install dependencies using composer
|
|
|
|
.. code:: bash
|
|
|
|
composer install
|
|
|
|
3. Install and compile assets:
|
|
|
|
.. code:: bash
|
|
|
|
yarn install
|
|
yarn run encore production
|
|
|
|
**note** double check that you have the node version > 20 using the
|
|
``node --version`` command.
|
|
|
|
4. configure your project: create a ``.env.local`` file at the root, and
|
|
add the admin password:
|
|
|
|
.. code:: dotenv
|
|
|
|
# for this installation mode, the environment should always be "dev"
|
|
APP_ENV=dev
|
|
ADMIN_PASSWORD=\$2y\$13\$iyvJLuT4YEa6iWXyQV4/N.hNHpNG8kXlYDkkt5MkYy4FXcSwYAwmm
|
|
# note: if you copy-paste the line above, the password will be "admin".
|
|
|
|
5. start the stack using ``docker compose up -d``, check the status of
|
|
the start with ``docker compose ps``
|
|
|
|
6. configure all the needed third-party tools
|
|
|
|
.. code:: bash
|
|
|
|
# the first start, it may last some seconds, you can check with docker compose ps
|
|
# run migrations
|
|
symfony console doctrine:migrations:migrate
|
|
# setup messenger
|
|
symfony console messenger:setup-transports
|
|
# prepare some views
|
|
symfony console chill:db:sync-views
|
|
# generate jwt token, required for some api features (webdav access, ...)
|
|
symfony console lexik:jwt:generate-keypair
|
|
|
|
7. add some fixtures
|
|
|
|
This will truncate all the existing data of the database. But remember,
|
|
we are in dev mode !
|
|
|
|
.. code:: bash
|
|
|
|
symfony console doctrine:fixtures:load
|
|
|
|
8. launch symfony dev-server
|
|
|
|
.. code:: bash
|
|
|
|
symfony server:start -d
|
|
|
|
And visit the web page it suggest. You can login with user
|
|
``center a_social`` and password ``password``, or login ``admin`` with
|
|
the password you set.
|
|
|
|
Stopping the server
|
|
-------------------
|
|
|
|
.. code:: bash
|
|
|
|
symfony server:stop
|
|
|
|
Restart the webserver for subsequent start
|
|
------------------------------------------
|
|
|
|
.. code:: bash
|
|
|
|
symfony server:start -d
|
|
# this will automatically starts the full docker compose services
|