Skip to content

Commit 4e53fa8

Browse files
committed
Base. Changed Cloud9 to CloudShell in README
1 parent 7f3eb45 commit 4e53fa8

File tree

1 file changed

+22
-15
lines changed

1 file changed

+22
-15
lines changed

lib/base/README.md

Lines changed: 22 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -68,9 +68,13 @@ This is the Well-Architected checklist for Ethereum nodes implementation of the
6868

6969
## Setup Instructions
7070

71-
### Setup Cloud9
71+
### Open AWS CloudShell
7272

73-
We will use AWS Cloud9 to execute the subsequent commands. Follow the instructions in [Cloud9 Setup](../../docs/setup-cloud9.md)
73+
To begin, ensure you login to your AWS account with permissions to create and modify resources in IAM, EC2, EBS, VPC, S3, KMS, and Secrets Manager.
74+
75+
From the AWS Management Console, open the [AWS CloudShell](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html), a web-based shell environment. If unfamiliar, review the [2-minute YouTube video](https://youtu.be/fz4rbjRaiQM) for an overview and check out [CloudShell with VPC environment](https://docs.aws.amazon.com/cloudshell/latest/userguide/creating-vpc-environment.html) that we'll use to test nodes API from internal IP address space.
76+
77+
Once ready, you can run the commands to deploy and test blueprints in the CloudShell.
7478

7579
### Make sure you have access to Ethereum L1 node
7680

@@ -175,25 +179,28 @@ BASE_L1_CONSENSUS_ENDPOINT="https://ethereum-sepolia-beacon-api.publicnode.com"
175179

176180
2. Deploy Base RPC Node and wait for it to sync. For Mainnet it might a day when using snapshots or about a week if syncing from block 0. You can use snapshots provided by the Base team by setting `BASE_RESTORE_FROM_SNAPSHOT="true"` in `.env` file.
177181

178-
```bash
179-
pwd
180-
# Make sure you are in aws-blockchain-node-runners/lib/base
181-
npx cdk deploy base-ha-nodes --json --outputs-file ha-nodes-deploy.json
182-
```
182+
```bash
183+
pwd
184+
# Make sure you are in aws-blockchain-node-runners/lib/base
185+
npx cdk deploy base-ha-nodes --json --outputs-file ha-nodes-deploy.json
186+
```
183187

184188
2. Give the new RPC **full** nodes about 5 hours to initialize and then run the following query against the load balancer behind the RPC node created.
185189

186-
```bash
187-
export RPC_ALB_URL=$(cat ha-nodes-deploy.json | jq -r '..|.alburl? | select(. != null)')
188-
echo $RPC_ALB_URL
189-
```
190+
```bash
191+
export RPC_ALB_URL=$(cat ha-nodes-deploy.json | jq -r '..|.alburl? | select(. != null)')
192+
echo RPC_ALB_URL=$RPC_ALB_URL
193+
```
190194

191195
Periodically check [Geth Syncing Status](https://geth.ethereum.org/docs/fundamentals/logs#syncing). Run the following query from within the same VPC and against the private IP of the load balancer fronting your nodes:
192196

193-
```bash
194-
curl http://$RPC_ALB_URL:8545 -X POST -H "Content-Type: application/json" \
195-
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
196-
```
197+
Copy output from the last `echo` command with `RPC_ALB_URL=<internal_IP>` and open [CloudShell tab with VPC environment](https://docs.aws.amazon.com/cloudshell/latest/userguide/creating-vpc-environment.html) to access internal IP address space. Paste `RPC_ALB_URL=<internal_IP>` into the new CloudShell tab. Then query the API:
198+
199+
``` bash
200+
# IMPORTANT: Run from CloudShell VPC environment tab
201+
curl http://$RPC_ALB_URL:8545 -X POST -H "Content-Type: application/json" \
202+
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
203+
```
197204

198205
**NOTE:** By default and for security reasons the load balancer is available only from within the default VPC in the region where it is deployed. It is not available from the Internet and is not open for external connections. Before opening it up please make sure you protect your RPC APIs.
199206

0 commit comments

Comments
 (0)