https://github.com/ironexdev/frostnova-devstack

https://github.com/ironexdev/frostnova-devstack

Last synced: over 1 year ago
JSON representation

• Host: GitHub
• URL: https://github.com/ironexdev/frostnova-devstack
• Owner: ironexdev
• Created: 2021-12-30T21:18:19.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2022-05-21T18:43:29.000Z (about 4 years ago)
• Last Synced: 2025-01-22T07:43:28.483Z (over 1 year ago)
• Language: Shell
• Size: 11.7 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Frostnova Development stack

Docker development stack for a micro PHP framework [Frostnova](https://github.com/ironexdev/frostnova-app)

It contains two rootless containers

- (Alpine) PHP-FPM container for the app

- (Alpine) Nginx container that serves as http-proxy to the app

## How to init development environment

1) Run `git clone git@github.com:ironexdev/frostnova.git`

2) Init submodules

- `bin/init`

3) Add following to etc/hosts

- `127.0.0.1 frostnova.local`

- Or customize the url in docker/images/http-proxy/default.conf

4) Generate Secrets

- Base version does not contain any secrets so this step is not needed, but it can be useful after adding database to the project.

- `bin/docker/compose/secrets`

- This command will complain "No such file or directory", but files with secrets should be created anyway.

5) Start Docker

- `bin/docker/compose/up`

6) Install dependencies

- `bin/docker/app/composer install`

## Command Reference

`bin/init`

- Pull submodules and add bin/docker symlink to docker submodule in order to make bin/docker commands work. 

`bin/submodule-update`

- Pull submodules

`bin/docker/app/composer `

- Run composer in app container

`bin/docker/app/console`

- Run Symfony Console command in app container

`bin/docker/app/run `

- Run command on API server

`bin/docker/app/xdebug`

- Set PHP Xdebug mode (https://xdebug.org/docs/all_settings#mode) in app container

`bin/docker/compose/build `

- Build or rebuild services

`bin/docker/compose/cleanup`

- Stop Docker, remove containers and images (optionally add "-v" flag and remove volumes)

`bin/docker/compose/down `

- Stop one or more running services

`bin/docker/compose/restart `

- Restart one or more services

`bin/docker/compose/run `

- Run custom docker-compose command

`bin/docker/compose/secrets`

- Generate Docker secrets

`bin/docker/compose/up`

- Build images if needed and create and start services

`bin/docker/clear-logs`

- Clear app and http-proxy logs