From 83003c01ee55041782f0be591d8a209f4b01d90a Mon Sep 17 00:00:00 2001 From: Michael Feng Date: Thu, 23 Feb 2023 13:15:57 -0800 Subject: [PATCH] cleanups --- .gitignore | 3 +++ README.md | 50 ++++++++++++++++++++++++++++++++---------- bash_scripts/README.md | 6 ++--- 3 files changed, 44 insertions(+), 15 deletions(-) diff --git a/.gitignore b/.gitignore index d059872..5e0da92 100644 --- a/.gitignore +++ b/.gitignore @@ -16,3 +16,6 @@ venv.bak/ *.log *.pem + +**/gateway_files/* +**/hummingbot_files/* \ No newline at end of file diff --git a/README.md b/README.md index eb3fd53..9a3c2bd 100644 --- a/README.md +++ b/README.md @@ -1,16 +1,30 @@ # 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. +## 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. +## 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. -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 -Each folder has a different example of how to deploy Hummingbot. -1. **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: +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. + +## Resources + +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 - 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 - Copy the certificates to the corresponding gateway path -2. **Simple Hummingbot Compose** -This example creates a single Hummingbot container. +### Simple Hummingbot Compose -3. **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 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. +This example creates a single Hummingbot container using docker-compose. + +### 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. -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. ## 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 . ``` diff --git a/bash_scripts/README.md b/bash_scripts/README.md index 8044de6..ca227f9 100644 --- a/bash_scripts/README.md +++ b/bash_scripts/README.md @@ -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. ``` -./create.sh +./hummingbot-create.sh ``` ### 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. ``` -./start.sh +./hummingbot-start.sh ``` ### 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. ``` -./update.sh +./hummingbot-update.sh ``` ## Gateway