Quick Start / Documents / Videos
What is sparrow and why should we use sparrow?
A Docker tool for one-click startup of multiple services.
Add a new service, please click here.
![image](https://private-user-images.githubusercontent.com/35942268/313711313-52d3a44c-5b89-4847-996e-ebef00a4a107.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjM5MDk5MjIsIm5iZiI6MTcyMzkwOTYyMiwicGF0aCI6Ii8zNTk0MjI2OC8zMTM3MTEzMTMtNTJkM2E0NGMtNWI4OS00ODQ3LTk5NmUtZWJlZjAwYTRhMTA3LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA4MTclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwODE3VDE1NDcwMlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWFhODc4NDgzMjU4NzNhNGJmZjMyMDEyN2FmZmY3NWY1NjI3ZWRkOTdhOWVlY2VmMTYxYTY1YWVlOWI5ZmI5NTMmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.16g5qBEDKQQkNgK0hD-WIJyJxM8zUNyTy13fyo5ybKc)
Here is a quick usage example. You can check Usage Document for detailed tutorials.
demo.mp4
You can use the following commands to install.
# get project
git clone https://github.com/WGrape/sparrow.git
cd sparrow
# install
bash _install.sh
After successful installation, a .env
file will be automatically generated in the project's root directory, it's the config entry for Sparrow, you can modify service versions, container namespace, and more. Refer to the .env.template file.
1、If you encounter some syntax errors while using the
./sparrow xxx
command, please try to run with bashbash ./sparrow xxx
command.2、When install, you will be prompted to enter
DOCKERHUB_REPO
, which is used to configure the remote repository for your Sparrow images. It's default value is docker.io/lvsid, if you need to modify it later, you can directly edit the.env
file.3、If you need help, check the Q&A Document for more help.
Use the following command to start all services in the entire environment. Of course, this all services
can be defined and is controlled by the ENABLE_SERVICE_LIST
array variable configured in the /.env
file in the root directory.
./sparrow start
If you only need to start a specific service, you can use the following command. The service
passed in is the name of a service in the services
list in the docker-compose.yml
configuration file, such as phpfpm/nginx/mysql/redis
, etc.
./sparrow startone {service_name}
Stop all services in the entire environment
./sparrow stop
The same, if you only need to stop a specific service, you can use the following command.
./sparrow stopone {service_name}
Restart all services in the entire environment
./sparrow restart
When a service needs to be updated, such as when its image content needs to be modified, the service (image) needs to be updated after making the modifications. After modifying it manually, use the following command to update it.
./sparrow updateone {service_name}
- 1.Project Background :English / 中文
- 2.Usage Document :English / 中文
- 3.Development Document :English / 中文
- 4.How to contribute :English / 中文
- 5.Q&A Document :English / 中文
During the use of the project, if you have any questions or suggestions, please submit issues or pull requests any time. About Contribution,please check How to Contribute document.