forked from cerc-io/stack-orchestrator
parent
78cd4e2e3e
commit
dfef77f35f
@ -8,9 +8,9 @@ Stack Orchestrator allows building and deployment of a Laconic Stack on a single
|
|||||||
|
|
||||||
Ensure that the following are already installed:
|
Ensure that the following are already installed:
|
||||||
|
|
||||||
- [Python3](https://wiki.python.org/moin/BeginnersGuide/Download)
|
- [Python3](https://wiki.python.org/moin/BeginnersGuide/Download): `python3 --version` >= `3.10.8`
|
||||||
- [Docker](https://docs.docker.com/get-docker/)
|
- [Docker](https://docs.docker.com/get-docker/): `docker --version` >= `20.10.21`
|
||||||
- [Docker Compose](https://docs.docker.com/compose/install/)
|
- [Docker Compose](https://docs.docker.com/compose/install/): `docker-compose --version` >= `2.13.0`
|
||||||
|
|
||||||
Note: if installing docker-compose via package manager (as opposed to Docker Desktop), you must [install the plugin](https://docs.docker.com/compose/install/linux/#install-the-plugin-manually), e.g., on Linux:
|
Note: if installing docker-compose via package manager (as opposed to Docker Desktop), you must [install the plugin](https://docs.docker.com/compose/install/linux/#install-the-plugin-manually), e.g., on Linux:
|
||||||
|
|
||||||
@ -97,7 +97,7 @@ laconic-so --verbose deploy-system --include ipld-eth-db,go-ethereum-foundry,ipl
|
|||||||
|
|
||||||
## Contributing
|
## Contributing
|
||||||
|
|
||||||
See the [CONTRIBUTING.md](.github/CONTRIBUTING.md) for developer mode install.
|
See the [CONTRIBUTING.md](/docs/CONTRIBUTING.md) for developer mode install.
|
||||||
|
|
||||||
## Platform Support
|
## Platform Support
|
||||||
|
|
||||||
|
@ -5,8 +5,11 @@ Thank you for taking the time to make a contribution to Stack Orchestrator.
|
|||||||
## Install (developer mode)
|
## Install (developer mode)
|
||||||
|
|
||||||
Suitable for developers either modifying or debugging the orchestrator Python code:
|
Suitable for developers either modifying or debugging the orchestrator Python code:
|
||||||
#### Prerequisites
|
|
||||||
In addition to the binary install prerequisites listed above, the following are required:
|
### Prerequisites
|
||||||
|
|
||||||
|
In addition to the pre-requisites listed in the [README](/README.md), the following are required:
|
||||||
|
|
||||||
1. Python venv package
|
1. Python venv package
|
||||||
This may or may not be already installed depending on the host OS and version. Check by running:
|
This may or may not be already installed depending on the host OS and version. Check by running:
|
||||||
```
|
```
|
||||||
@ -18,26 +21,32 @@ In addition to the binary install prerequisites listed above, the following are
|
|||||||
```
|
```
|
||||||
$ apt install python3.10-venv
|
$ apt install python3.10-venv
|
||||||
```
|
```
|
||||||
#### Install
|
|
||||||
|
### Install
|
||||||
|
|
||||||
1. Clone this repository:
|
1. Clone this repository:
|
||||||
```
|
```
|
||||||
$ git clone (https://github.com/cerc-io/stack-orchestrator.git
|
$ git clone (https://github.com/cerc-io/stack-orchestrator.git
|
||||||
```
|
```
|
||||||
4. Enter the project directory:
|
|
||||||
|
2. Enter the project directory:
|
||||||
```
|
```
|
||||||
$ cd stack-orchestrator
|
$ cd stack-orchestrator
|
||||||
```
|
```
|
||||||
5. Create and activate a venv:
|
|
||||||
|
3. Create and activate a venv:
|
||||||
```
|
```
|
||||||
$ python3 -m venv venv
|
$ python3 -m venv venv
|
||||||
$ source ./venv/bin/activate
|
$ source ./venv/bin/activate
|
||||||
(venv) $
|
(venv) $
|
||||||
```
|
```
|
||||||
6. Install the cli in edit mode:
|
|
||||||
|
4. Install the cli in edit mode:
|
||||||
```
|
```
|
||||||
$ pip install --editable .
|
$ pip install --editable .
|
||||||
```
|
```
|
||||||
7. Verify installation:
|
|
||||||
|
5. Verify installation:
|
||||||
```
|
```
|
||||||
(venv) $ laconic-so
|
(venv) $ laconic-so
|
||||||
Usage: laconic-so [OPTIONS] COMMAND [ARGS]...
|
Usage: laconic-so [OPTIONS] COMMAND [ARGS]...
|
||||||
@ -56,19 +65,23 @@ In addition to the binary install prerequisites listed above, the following are
|
|||||||
setup-repositories git clone the set of repositories required to build...
|
setup-repositories git clone the set of repositories required to build...
|
||||||
```
|
```
|
||||||
|
|
||||||
#### Build a zipapp (single file distributable script)
|
## Build a zipapp (single file distributable script)
|
||||||
|
|
||||||
Use shiv to build a single file Python executable zip archive of laconic-so:
|
Use shiv to build a single file Python executable zip archive of laconic-so:
|
||||||
|
|
||||||
1. Install [shiv](https://github.com/linkedin/shiv):
|
1. Install [shiv](https://github.com/linkedin/shiv):
|
||||||
```
|
```
|
||||||
$ (venv) pip install shiv
|
$ (venv) pip install shiv
|
||||||
$ (venv) pip install wheel
|
$ (venv) pip install wheel
|
||||||
```
|
```
|
||||||
1. Run shiv to create a zipapp file:
|
|
||||||
|
2. Run shiv to create a zipapp file:
|
||||||
```
|
```
|
||||||
$ (venv) shiv -c laconic-so -o laconic-so .
|
$ (venv) shiv -c laconic-so -o laconic-so .
|
||||||
```
|
```
|
||||||
This creates a file `./laconic-so` that is executable outside of any venv, and on other machines and OSes and architectures, and requiring only the system Python3:
|
This creates a file `./laconic-so` that is executable outside of any venv, and on other machines and OSes and architectures, and requiring only the system Python3:
|
||||||
1. Verify it works:
|
|
||||||
|
3. Verify it works:
|
||||||
```
|
```
|
||||||
$ cp stack-orchetrator/laconic-so ~/bin
|
$ cp stack-orchetrator/laconic-so ~/bin
|
||||||
$ laconic-so
|
$ laconic-so
|
||||||
@ -88,4 +101,4 @@ Use shiv to build a single file Python executable zip archive of laconic-so:
|
|||||||
setup-repositories git clone the set of repositories required to build...
|
setup-repositories git clone the set of repositories required to build...
|
||||||
```
|
```
|
||||||
|
|
||||||
|
For cutting releases, use the [shiv build script](/scripts/build_shiv_package.sh).
|
Loading…
Reference in New Issue
Block a user