forked from cerc-io/stack-orchestrator
Compare commits
5
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
6c49520e69 | ||
|
|
70d34e6751 | ||
|
|
c6de6d6067 | ||
|
|
69b6b9a873 | ||
|
|
430b884d72 |
@@ -1,98 +0,0 @@
|
|||||||
# fixturenet-eth
|
|
||||||
|
|
||||||
Instructions for deploying a local a geth + lighthouse blockchain "fixturenet" for development and testing purposes using laconic-stack-orchestrator (the installation of which is covered [here](https://github.com/cerc-io/stack-orchestrator#user-mode)):
|
|
||||||
|
|
||||||
## Clone required repositories
|
|
||||||
```
|
|
||||||
$ laconic-so --stack fixturenet-eth setup-repositories
|
|
||||||
```
|
|
||||||
|
|
||||||
## Build the fixturenet-eth containers
|
|
||||||
```
|
|
||||||
$ laconic-so --stack fixturenet-eth build-containers
|
|
||||||
```
|
|
||||||
This should create several container images in the local image registry:
|
|
||||||
|
|
||||||
* cerc/go-ethereum
|
|
||||||
* cerc/lighthouse
|
|
||||||
* cerc/fixturenet-eth-geth
|
|
||||||
* cerc/fixturenet-eth-lighthouse
|
|
||||||
|
|
||||||
## Deploy the stack
|
|
||||||
```
|
|
||||||
$ laconic-so --stack fixturenet-eth deploy-system up
|
|
||||||
```
|
|
||||||
|
|
||||||
## Check status
|
|
||||||
|
|
||||||
```
|
|
||||||
$ container-build/cerc-fixturenet-eth-lighthouse/scripts/status.sh
|
|
||||||
Waiting for geth to generate DAG ..................................................... DONE!
|
|
||||||
Waiting for beacon phase0 .... DONE!
|
|
||||||
Waiting for beacon altair .... DONE!
|
|
||||||
Waiting for beacon bellatrix pre-merge .... DONE!
|
|
||||||
Waiting for beacon bellatrix merge .... DONE!
|
|
||||||
|
|
||||||
$ docker ps -f 'name=laconic' --format 'table {{.Names}}\t{{.Ports}}' | cut -d'-' -f3- | sort
|
|
||||||
NAMES PORTS
|
|
||||||
fixturenet-eth-bootnode-geth-1 8545-8546/tcp, 30303/udp, 0.0.0.0:55847->9898/tcp, 0.0.0.0:55848->30303/tcp
|
|
||||||
fixturenet-eth-bootnode-lighthouse-1
|
|
||||||
fixturenet-eth-geth-1-1 8546/tcp, 30303/tcp, 30303/udp, 0.0.0.0:55851->8545/tcp
|
|
||||||
fixturenet-eth-geth-2-1 8545-8546/tcp, 30303/tcp, 30303/udp
|
|
||||||
fixturenet-eth-lighthouse-1-1 0.0.0.0:55858->8001/tcp
|
|
||||||
fixturenet-eth-lighthouse-2-1
|
|
||||||
```
|
|
||||||
|
|
||||||
## Additional pieces
|
|
||||||
|
|
||||||
Several other containers can used with the basic `fixturenet-eth`:
|
|
||||||
|
|
||||||
* `ipld-eth-db` (enables statediffing)
|
|
||||||
* `ipld-eth-server` (GQL and Ethereum API server, requires `ipld-eth-db`)
|
|
||||||
* `ipld-eth-beacon-db` and `ipld-eth-beacon-indexer` (for indexing Beacon chain blocks)
|
|
||||||
* `eth-probe` (captures eth1 tx gossip)
|
|
||||||
* `keycloak` (nginx proxy with keycloak auth for API authentication)
|
|
||||||
* `tx-spammer` (generates and sends automated transactions to the fixturenet)
|
|
||||||
|
|
||||||
It is not necessary to use them all at once, but a complete example follows:
|
|
||||||
|
|
||||||
```
|
|
||||||
# Setup
|
|
||||||
$ laconic-so setup-repositories --include cerc-io/go-ethereum,cerc-io/ipld-eth-db,cerc-io/ipld-eth-server,cerc-io/ipld-eth-beacon-db,cerc-io/ipld-eth-beacon-indexer,cerc-io/eth-probe,cerc-io/tx-spammer
|
|
||||||
|
|
||||||
# Build
|
|
||||||
$ laconic-so build-containers --include cerc/go-ethereum,cerc/lighthouse,cerc/fixturenet-eth-geth,cerc/fixturenet-eth-lighthouse,cerc/ipld-eth-db,cerc/ipld-eth-server,cerc/ipld-eth-beacon-db,cerc/ipld-eth-beacon-indexer,cerc/eth-probe,cerc/keycloak,cerc/tx-spammer
|
|
||||||
|
|
||||||
# Deploy
|
|
||||||
$ laconic-so deploy-system --include db,fixturenet-eth,ipld-eth-server,ipld-eth-beacon-db,ipld-eth-beacon-indexer,eth-probe,keycloak,tx-spammer up
|
|
||||||
|
|
||||||
# Status
|
|
||||||
|
|
||||||
$ container-build/cerc-fixturenet-eth-lighthouse/scripts/status.sh
|
|
||||||
Waiting for geth to generate DAG.... DONE!
|
|
||||||
Waiting for beacon phase0.... DONE!
|
|
||||||
Waiting for beacon altair.... DONE!
|
|
||||||
Waiting for beacon bellatrix pre-merge.... DONE!
|
|
||||||
Waiting for beacon bellatrix merge.... DONE!
|
|
||||||
|
|
||||||
$ docker ps -f 'name=laconic' --format 'table {{.Names}}\t{{.Ports}}' | cut -d'-' -f3- | sort
|
|
||||||
NAMES PORTS
|
|
||||||
eth-probe-db-1 0.0.0.0:55849->5432/tcp
|
|
||||||
eth-probe-mq-1
|
|
||||||
eth-probe-probe-1
|
|
||||||
fixturenet-eth-bootnode-geth-1 8545-8546/tcp, 30303/udp, 0.0.0.0:55847->9898/tcp, 0.0.0.0:55848->30303/tcp
|
|
||||||
fixturenet-eth-bootnode-lighthouse-1
|
|
||||||
fixturenet-eth-geth-1-1 8546/tcp, 30303/tcp, 30303/udp, 0.0.0.0:55851->8545/tcp
|
|
||||||
fixturenet-eth-geth-2-1 8545-8546/tcp, 30303/tcp, 30303/udp
|
|
||||||
fixturenet-eth-lighthouse-1-1 0.0.0.0:55858->8001/tcp
|
|
||||||
fixturenet-eth-lighthouse-2-1
|
|
||||||
ipld-eth-beacon-db-1 127.0.0.1:8076->5432/tcp
|
|
||||||
ipld-eth-beacon-indexer-1
|
|
||||||
ipld-eth-db-1 127.0.0.1:8077->5432/tcp
|
|
||||||
ipld-eth-server-1 127.0.0.1:8081-8082->8081-8082/tcp
|
|
||||||
keycloak-1 8443/tcp, 0.0.0.0:55857->8080/tcp
|
|
||||||
keycloak-db-1 0.0.0.0:55850->5432/tcp
|
|
||||||
keycloak-nginx-1 0.0.0.0:55859->80/tcp
|
|
||||||
migrations-1
|
|
||||||
tx-spammer-1
|
|
||||||
```
|
|
||||||
@@ -1,17 +0,0 @@
|
|||||||
version: "1.0"
|
|
||||||
name: fixturenet-eth-statediff
|
|
||||||
decription: "Loaded Ethereum Fixturenet"
|
|
||||||
repos:
|
|
||||||
- cerc-io/go-ethereum
|
|
||||||
- cerc-io/tx-spammer
|
|
||||||
- cerc-io/ipld-eth-db
|
|
||||||
containers:
|
|
||||||
- cerc/lighthouse
|
|
||||||
- cerc/fixturenet-eth-geth
|
|
||||||
- cerc/fixturenet-eth-lighthouse
|
|
||||||
- cerc/ipld-eth-db
|
|
||||||
- cerc/tx-spammer
|
|
||||||
pods:
|
|
||||||
- fixturenet-eth
|
|
||||||
- tx-spammer
|
|
||||||
- ipld-eth-db
|
|
||||||
@@ -1,2 +1,2 @@
|
|||||||
# This file should be re-generated running: scripts/update-version-file.sh script
|
# This file should be re-generated running: scripts/update-version-file.sh script
|
||||||
v1.0.21-c52f9e6
|
v1.0.22-4fdb442
|
||||||
|
|||||||
@@ -76,8 +76,10 @@ def command(ctx, include, exclude, cluster, command, extra_args):
|
|||||||
service_name = extra_args_list[0]
|
service_name = extra_args_list[0]
|
||||||
command_to_exec = extra_args_list[1:]
|
command_to_exec = extra_args_list[1:]
|
||||||
container_exec_env = {
|
container_exec_env = {
|
||||||
"CERC_SCRIPT_DEBUG": "true"
|
"CERC_HOST_UID": f"{os.getuid()}",
|
||||||
} if debug else {}
|
"CERC_HOST_GID": f"{os.getgid()}"
|
||||||
|
}
|
||||||
|
container_exec_env.update({"CERC_SCRIPT_DEBUG": "true"} if debug else {})
|
||||||
if verbose:
|
if verbose:
|
||||||
print(f"Running compose exec {service_name} {command_to_exec}")
|
print(f"Running compose exec {service_name} {command_to_exec}")
|
||||||
docker.compose.execute(service_name, command_to_exec, envs=container_exec_env)
|
docker.compose.execute(service_name, command_to_exec, envs=container_exec_env)
|
||||||
@@ -151,10 +153,13 @@ def _make_cluster_context(ctx, include, exclude, cluster):
|
|||||||
compose_dir = Path(__file__).absolute().parent.joinpath("data", "compose")
|
compose_dir = Path(__file__).absolute().parent.joinpath("data", "compose")
|
||||||
|
|
||||||
if cluster is None:
|
if cluster is None:
|
||||||
# Create default unique, stable cluster name from confile file path
|
# Create default unique, stable cluster name from confile file path and stack name if provided
|
||||||
# TODO: change this to the config file path
|
# TODO: change this to the config file path
|
||||||
path = os.path.realpath(sys.argv[0])
|
path = os.path.realpath(sys.argv[0])
|
||||||
hash = hashlib.md5(path.encode()).hexdigest()
|
unique_cluster_descriptor = f"{path},{ctx.stack},{include},{exclude}"
|
||||||
|
if ctx.debug:
|
||||||
|
print(f"pre-hash descriptor: {unique_cluster_descriptor}")
|
||||||
|
hash = hashlib.md5(unique_cluster_descriptor.encode()).hexdigest()
|
||||||
cluster = f"laconic-{hash}"
|
cluster = f"laconic-{hash}"
|
||||||
if ctx.verbose:
|
if ctx.verbose:
|
||||||
print(f"Using cluster name: {cluster}")
|
print(f"Using cluster name: {cluster}")
|
||||||
|
|||||||
@@ -55,5 +55,6 @@ def cli(ctx, stack, quiet, verbose, dry_run, local_stack, debug, continue_on_err
|
|||||||
cli.add_command(setup_repositories.command, "setup-repositories")
|
cli.add_command(setup_repositories.command, "setup-repositories")
|
||||||
cli.add_command(build_containers.command, "build-containers")
|
cli.add_command(build_containers.command, "build-containers")
|
||||||
cli.add_command(build_npms.command, "build-npms")
|
cli.add_command(build_npms.command, "build-npms")
|
||||||
|
cli.add_command(deploy_system.command, "deploy") # deploy is an alias for deploy-system
|
||||||
cli.add_command(deploy_system.command, "deploy-system")
|
cli.add_command(deploy_system.command, "deploy-system")
|
||||||
cli.add_command(version.command, "version")
|
cli.add_command(version.command, "version")
|
||||||
|
|||||||
Reference in New Issue
Block a user