mirror of
https://github.com/d0zingcat/deploy.git
synced 2026-05-31 15:10:33 +00:00
cleanups
This commit is contained in:
3
.gitignore
vendored
3
.gitignore
vendored
@@ -16,3 +16,6 @@ venv.bak/
|
|||||||
|
|
||||||
*.log
|
*.log
|
||||||
*.pem
|
*.pem
|
||||||
|
|
||||||
|
**/gateway_files/*
|
||||||
|
**/hummingbot_files/*
|
||||||
50
README.md
50
README.md
@@ -1,16 +1,30 @@
|
|||||||
# deploy-examples
|
# deploy-examples
|
||||||
|
|
||||||
|
## Intro
|
||||||
|
|
||||||
This repository provides various examples of how to deploy Hummingbot using Docker. Hummingbot is a powerful, open-source trading bot for cryptocurrency markets, and Docker is a popular platform for building, shipping, and running distributed applications.
|
This repository provides various examples of how to deploy Hummingbot using Docker. Hummingbot is a powerful, open-source trading bot for cryptocurrency markets, and Docker is a popular platform for building, shipping, and running distributed applications.
|
||||||
|
|
||||||
|
## Why use Docker?
|
||||||
|
|
||||||
Using Docker for Hummingbot deployment offers several benefits, such as simplifying the installation process, enabling easy versioning and scaling, and ensuring a consistent and isolated environment for running the bot. This repository aims to help users get started with deploying Hummingbot using Docker by providing different examples that demonstrate how to set up and customize the bot according to their needs.
|
Using Docker for Hummingbot deployment offers several benefits, such as simplifying the installation process, enabling easy versioning and scaling, and ensuring a consistent and isolated environment for running the bot. This repository aims to help users get started with deploying Hummingbot using Docker by providing different examples that demonstrate how to set up and customize the bot according to their needs.
|
||||||
|
|
||||||
|
## Why does this repo contain?
|
||||||
|
|
||||||
The repository includes multiple Docker Compose files, each showcasing a different deployment scenario, such as running Hummingbot with different exchange connectors, customizing the configuration, or integrating with other services. Additionally, the repository provides a detailed README file that guides users through the steps required to deploy Hummingbot using Docker, including how to build and run the containers, how to configure the bot, and how to monitor its performance.
|
The repository includes multiple Docker Compose files, each showcasing a different deployment scenario, such as running Hummingbot with different exchange connectors, customizing the configuration, or integrating with other services. Additionally, the repository provides a detailed README file that guides users through the steps required to deploy Hummingbot using Docker, including how to build and run the containers, how to configure the bot, and how to monitor its performance.
|
||||||
|
|
||||||
This repository is intended for developers and traders who want to deploy Hummingbot using Docker and explore its features and capabilities. Contributions are welcome, and users are encouraged to share their own examples and use cases for deploying Hummingbot with Docker..
|
## Who is it for?
|
||||||
|
|
||||||
## How to navigate the repo
|
This repository is intended for developers and traders who want to deploy Hummingbot using Docker and explore its features and capabilities. Contributions are welcome, and users are encouraged to share their own examples and use cases for deploying Hummingbot with Docker.
|
||||||
Each folder has a different example of how to deploy Hummingbot.
|
|
||||||
1. **Bash scripts**:
|
## Resources
|
||||||
Use this repository to create standalone containers of Hummingbot and Gateway. For example, you can run the client from the source and use the gateway with it by utilizing the gateway-create.sh file. The following operations are possible using the Bash scripts:
|
|
||||||
|
Each folder has a different method of deploying the Hummingbot client, Hummingbot Gateway DEX connector module, and other components in the Hummingbot ecosystem.
|
||||||
|
|
||||||
|
### Bash scripts
|
||||||
|
|
||||||
|
Use this repository to create standalone containers of Hummingbot and Gateway. For example, you can run the client from the source and use the gateway with it by utilizing the `gateway-create.sh` file.
|
||||||
|
|
||||||
|
The following operations are possible using the Bash scripts:
|
||||||
|
|
||||||
- Create a Hummingbot container
|
- Create a Hummingbot container
|
||||||
- Update the Hummingbot image version
|
- Update the Hummingbot image version
|
||||||
@@ -18,20 +32,32 @@ Use this repository to create standalone containers of Hummingbot and Gateway. F
|
|||||||
- Create a Gateway container
|
- Create a Gateway container
|
||||||
- Copy the certificates to the corresponding gateway path
|
- Copy the certificates to the corresponding gateway path
|
||||||
|
|
||||||
2. **Simple Hummingbot Compose**
|
### Simple Hummingbot Compose
|
||||||
This example creates a single Hummingbot container.
|
|
||||||
|
|
||||||
3. **Autostart Hummingbot Compose**
|
This example creates a single Hummingbot container using docker-compose.
|
||||||
This example is a variation of the Simple Hummingbot Compose, with the ability to autostart a script or a strategy. The `.password_verification` file contains the encrypted password, which is `a`. Follow the Troubleshooting guide provided in the `README.md` file of that folder to understand how to change it and use your password. This folder also includes a script called `format_status.py`, and a `conf_pure_mm_1.yml` file inside the conf/strategies directory. These files are necessary to autostart the bot since the environment variables `CONFIG_PASSWORD` and `CONFIG_FILE_NAME` are essential.
|
|
||||||
|
### Autostart Hummingbot Compose
|
||||||
|
|
||||||
|
This example is a variation of the Simple Hummingbot Compose, with the ability to autostart a script or a strategy. The `.password_verification` file contains the encrypted password, which is `a`.
|
||||||
|
|
||||||
|
Follow the Troubleshooting guide provided in the `README.md` file of the folder to understand how to change it and use your password.
|
||||||
|
|
||||||
|
This folder also includes a script called `format_status.py`, and a `conf_pure_mm_1.yml` file inside the conf/strategies directory. These files are necessary to autostart the bot since the environment variables `CONFIG_PASSWORD` and `CONFIG_FILE_NAME` are essential.
|
||||||
|
|
||||||
|
### Hummingbot Gateway Compose
|
||||||
|
|
||||||
4. **Hummingbot Gateway Compose**
|
|
||||||
This example shows how to run Hummingbot with Gateway with just one command. The only essential thing to consider is managing the certificates.
|
This example shows how to run Hummingbot with Gateway with just one command. The only essential thing to consider is managing the certificates.
|
||||||
|
|
||||||
5. **Multiple Hummingbot Gateway Compose**
|
### Multiple Hummingbot Gateway Compose
|
||||||
|
|
||||||
This example demonstrates how to run multiple Hummingbot instances with Gateway with just one command. The only essential thing to consider is managing the certificates.
|
This example demonstrates how to run multiple Hummingbot instances with Gateway with just one command. The only essential thing to consider is managing the certificates.
|
||||||
|
|
||||||
## IMPORTANT
|
## IMPORTANT
|
||||||
All the docker-compose files use hummingbot/hummingbot:latest and hummingbot/gateway:latest as images to create the containers. If you are using a machine with ARM, we strongly recommend building your local image by cloning the official repository and running the command:
|
|
||||||
|
By default, the docker-compose files use the `hummingbot/hummingbot:latest` and `hummingbot/gateway:latest` images to create the containers.
|
||||||
|
|
||||||
|
If you are using a machine with ARM, we strongly recommend build a local HUmmingbot image instead by cloning the official repository and running the command:
|
||||||
|
|
||||||
```
|
```
|
||||||
docker build -f Dockerfile.arm -t hummingbot/hummingbot:arm .
|
docker build -f Dockerfile.arm -t hummingbot/hummingbot:arm .
|
||||||
```
|
```
|
||||||
|
|||||||
@@ -26,7 +26,7 @@ They also assume that the user has Docker permissions without requiring `sudo`.
|
|||||||
The `hummingbot-create.sh` script will create the folders needed to run Hummingbot and then install Hummingbot.
|
The `hummingbot-create.sh` script will create the folders needed to run Hummingbot and then install Hummingbot.
|
||||||
|
|
||||||
```
|
```
|
||||||
./create.sh
|
./hummingbot-create.sh
|
||||||
```
|
```
|
||||||
|
|
||||||
### Start up / connect to an instance of Hummingbot
|
### Start up / connect to an instance of Hummingbot
|
||||||
@@ -34,7 +34,7 @@ The `hummingbot-create.sh` script will create the folders needed to run Hummingb
|
|||||||
The `hummingbot-start.sh` script will connect to a running instance of Hummingbot.
|
The `hummingbot-start.sh` script will connect to a running instance of Hummingbot.
|
||||||
|
|
||||||
```
|
```
|
||||||
./start.sh
|
./hummingbot-start.sh
|
||||||
```
|
```
|
||||||
|
|
||||||
### Updating Hummingbot version
|
### Updating Hummingbot version
|
||||||
@@ -42,7 +42,7 @@ The `hummingbot-start.sh` script will connect to a running instance of Hummingbo
|
|||||||
The `hummingbot-update.sh` script will update your instance to the latest version of Hummingbot.
|
The `hummingbot-update.sh` script will update your instance to the latest version of Hummingbot.
|
||||||
|
|
||||||
```
|
```
|
||||||
./update.sh
|
./hummingbot-update.sh
|
||||||
```
|
```
|
||||||
|
|
||||||
## Gateway
|
## Gateway
|
||||||
|
|||||||
Reference in New Issue
Block a user