{"id":22244032,"url":"https://github.com/agence-webup/pliz","last_synced_at":"2025-09-05T00:39:00.438Z","repository":{"id":45251064,"uuid":"78223403","full_name":"agence-webup/pliz","owner":"agence-webup","description":"A CLI tool to manage web projects","archived":false,"fork":false,"pushed_at":"2025-03-19T16:50:02.000Z","size":172,"stargazers_count":5,"open_issues_count":3,"forks_count":0,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-04T11:24:55.667Z","etag":null,"topics":["cli","docker","go","golang","ops"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/agence-webup.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-01-06T17:05:42.000Z","updated_at":"2025-03-12T14:48:34.000Z","dependencies_parsed_at":"2024-08-12T14:15:33.221Z","dependency_job_id":null,"html_url":"https://github.com/agence-webup/pliz","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/agence-webup/pliz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agence-webup%2Fpliz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agence-webup%2Fpliz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agence-webup%2Fpliz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agence-webup%2Fpliz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/agence-webup","download_url":"https://codeload.github.com/agence-webup/pliz/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agence-webup%2Fpliz/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267453793,"owners_count":24089831,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-28T02:00:09.689Z","response_time":68,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","docker","go","golang","ops"],"created_at":"2024-12-03T04:31:56.478Z","updated_at":"2025-07-28T02:31:45.814Z","avatar_url":"https://github.com/agence-webup.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pliz\n\nPliz is a CLI tool wrapping some Docker/Docker Compose commands allowing to execute some tasks in a web project. Few examples:\n\n* build the project: build images, start containers and execute tasks like `npm install` or `gulp`.\n* start/stop the project\n* execute some tasks\n* backup/restore a running project (database \u0026 files)\n\nPliz makes some assumptions:\n\n* Docker \u0026 Docker Compose must be used to develop and run a web project\n* a project is composed of 4 Compose services: `app` (PHP by default), `db` (MySQL by default), `proxy` (nginx by default) and `srcbuild` (NodeJS stuff).\n* some default tasks are defined inside Pliz: `bower`, `composer`, `db:update`, `gulp`, `npm`.\n* configuration can be made using a `pliz.yml` file at project root. This configuration file can be used to:\n\n    * override Compose service names\n    * define configuration files inside the project that must be created by developers\n    * define installation tasks (see below `pliz install`)\n    * override default tasks behaviour\n    * define new tasks\n    * define some additionnal services to start with default ones\n    * define backup content\n\nLook at [pliz.example.yml](https://github.com/agence-webup/pliz/blob/master/pliz.example.yml) to see an example.\n\n## How to use it\n\n### Installation\n\nDownload the binary from [releases](https://github.com/agence-webup/pliz/releases) for your system and move it into your `$PATH` (for example: `/usr/local/bin/pliz`)\n\n### Usage\n\nJust call `pliz` and some help will be displayed (The command must be run in a Docker Compose project and a `pliz.yml` file must be present):\n\n```bash\n% pliz\n\nUsage: pliz [OPTIONS] COMMAND [arg...]\n\nManage projects building\n\nOptions:\n  -v, --version    Show the version and exit\n  --env=\"\"         Change the environnment of Pliz (i.e. 'prod'). The environment var 'PLIZ_ENV' can be use too.\n\nCommands:\n  start        Start (or restart) the project\n  stop         Stop the project\n  install      Install (or update) the project dependencies (docker containers, npm, composer...)\n  bash         Display a shell inside the builder service (or the specified service)\n  logs         Display logs of all services (or the specified service)\n  run          Execute a single task\n  backup       Perform a backup of the project\n  restore      Restore a backup (Warning: files will be overrided)\n\nRun 'pliz COMMAND --help' for more information on a command.\n```\n\nYou can visit this project to see a use case of Pliz : [https://github.com/agence-webup/laravel-skeleton](https://github.com/agence-webup/laravel-skeleton)\n\n_More documentation coming later_\n\n## Building\n\n### Compile Pliz\n\n```bash\n$ make\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagence-webup%2Fpliz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagence-webup%2Fpliz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagence-webup%2Fpliz/lists"}