From 332907a139b5a3d7e87e813056efeccafe1a4936 Mon Sep 17 00:00:00 2001 From: evilsocket Date: Thu, 12 Dec 2024 19:53:43 +0100 Subject: [PATCH 1/2] docs: README changes (ENG-570) --- README.md | 53 ++++++++++++++++++++++++++++++++++++++++------------- 1 file changed, 40 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index d40ba85..48a50dc 100644 --- a/README.md +++ b/README.md @@ -21,36 +21,35 @@ Dreadnode command line interface
-## Installation +## Installing -### From PyPi: +### From PyPi ```bash pip install dreadnode-cli ``` -### With Poetry: - -This project is packaged for and meant to be used with the [Poetry package management tool](https://python-poetry.org/). - -To install the project dependencies: +To upgrade the CLI to the latest version, run: ```bash -poetry install +pip install --upgrade dreadnode-cli ``` -And then enter its shell: +To uninstall the CLI, run: ```bash -poetry shell +pip uninstall dreadnode-cli ``` -### With Docker: +> [!IMPORTANT] +> The data folder with authentication credentials is located at `~/.dreadnode` and will not be automatically removed when uninstalling the CLI. -Alternatively, you can build a docker image and run the CLI from a container: +### From Docker Hub + +To pull the latest CLI image from Docker Hub, run: ```bash -docker build -t dreadnode . +docker pull dreadnode/dreadnode-cli ``` Whenever using the CLI from a docker container, remember to share your user configuration, the network from the host and mount the docker socket: @@ -175,3 +174,31 @@ dreadnode agent versions # switch/link to a different agent dreadnode agent switch ``` + +## Development + +### Poetry Shell + +This project uses the [Poetry package management tool](https://python-poetry.org/), to install from source run the following commands: + +```bash +git clone https://github.com/dreadnode/cli.git +cd cli +poetry install +``` + +You can then enter the project's virtual environment: + +```bash +poetry shell +``` + +## Building the Docker Image + +Alternatively, you can build a docker image and run the CLI from a container: + +```bash +git clone https://github.com/dreadnode/cli.git +cd cli +docker build -t dreadnode . +``` \ No newline at end of file From 987c499e27de59a617b09b41c63ba58b099c5277 Mon Sep 17 00:00:00 2001 From: evilsocket Date: Thu, 12 Dec 2024 19:56:41 +0100 Subject: [PATCH 2/2] docs: fixed header --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 48a50dc..494d68b 100644 --- a/README.md +++ b/README.md @@ -193,7 +193,7 @@ You can then enter the project's virtual environment: poetry shell ``` -## Building the Docker Image +### Building the Docker Image Alternatively, you can build a docker image and run the CLI from a container: