Operations grimoire/Login

Login is handled by Auth Grove

Application information

• Repository: rGROVE
• Maintainer: Dereckson
• Written in PHP, use Laravel, Laravel Socialite and Keruald libraries

Run it

Deployment information

• Deployed on Docker
• Docker image: rDGROVE
• Needs MySQL, both for prod and on CI

Start a new container

run-login

Upgrade a live container

1. Enter notifications container as app user : docker exec -it --user=app login bash
2. Check we're on the master branch and the history is clean
3.  Update code rebasing the production branch against origin/master
4. If composer has been touched, composer update (could be faster to docker pull, stop this container and start a new container)
5. To upgrade database schema, php artisan migrate
6.  If entered as root, fix ownership with chown -R app:app /var/wwwroot/default
7.  Restart PHP FPM with sv restart php-fpm
8. Run php optimize to refresh compiled class
9.  Restart again PHP FPM with sv restart php-fpm

For longer upgrade, you can put the application in maintenance mode with php artisan down.

If preferences are updated (in the code or by us), update the cache: php artisan config:cache && sv restart php-fpm is needed.

How to rebase against master?

1. update master to match origin/master
2. rebase production against master

$ git fetch
$ git checkout master
$ git rebase origin/master
$ git checkout production
$ git rebase master

If there is a merge conflict:

1. Edit the conflict files
2. git add <edited files>
3. git rebase --continue

Troubleshooting

URL issue

If URL are in http://localhost, ensure the web server passes proxy forwarding information (include proxy_params in nginx), as the application guess links.

Configuration as code.

This service should be properly defined in rOPS repository as a Salt state.