Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kubetrail/geth-deployment
Kubernetes manifests for deploying geth in dev mode, i.e. an Ethereum proof-of-authority single node for testing purposes
https://github.com/kubetrail/geth-deployment
ethereum geth geth-node kubernetes-deployment metamask
Last synced: 7 days ago
JSON representation
Kubernetes manifests for deploying geth in dev mode, i.e. an Ethereum proof-of-authority single node for testing purposes
- Host: GitHub
- URL: https://github.com/kubetrail/geth-deployment
- Owner: kubetrail
- License: apache-2.0
- Created: 2022-03-03T04:41:53.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2022-03-03T17:25:15.000Z (almost 3 years ago)
- Last Synced: 2024-12-23T00:06:03.379Z (29 days ago)
- Topics: ethereum, geth, geth-node, kubernetes-deployment, metamask
- Language: Makefile
- Homepage:
- Size: 18.6 KB
- Stars: 0
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# geth-deployment
Deploy `geth` to a k8s cluster in `dev` node running
as an Ethereum single node testnet with proof-of-authority (PoA) consensus
## disclaimer
> The use of this tool does not guarantee security or usability for any
> particular purpose. Please review the code and use at your own risk.
## installation
first download the code, build container image and push
to your container registry.
> please make sure go toolchain and docker are installed
> at relatively newer versions and also update the
> IMG value to point to your registry
```bash
export IMG=docker.io/your-account-name/geth:v1.10.16
make manifests
make docker-build
make docker-push
```
once the container image is available in your registry you can
deploy `geth` to a kubernetes cluster.
```bash
make deploy
```
The status of k8s resources should appear as follows:
```bash
kubectl --namespace=geth-system get pods,svc,configmaps,secrets dusy: Thu Mar 3 09:00:15 2022
NAME READY STATUS RESTARTS AGE
pod/geth-controller-manager-65dcc9f484-27dpt 1/1 Running 0 4m18s
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
service/geth-geth ClusterIP 10.107.236.154 8545/TCP,8546/TCP 4m20s
NAME DATA AGE
configmap/kube-root-ca.crt 1 4m20s
NAME TYPE DATA AGE
secret/artifact-registry-key kubernetes.io/dockerconfigjson 1 4m20s
secret/default-token-m7tpn kubernetes.io/service-account-token 3 4m20s
secret/geth-controller-manager-token-lbn6t kubernetes.io/service-account-token 3 4m20s
```
## interact with the chain
Exec into the pod by running `geth attach` command as shown below:
```bash
make console
Welcome to the Geth JavaScript console!
instance: Geth/v1.10.16-stable-20356e57/linux-arm64/go1.17.7
coinbase: 0x
at block: 1 (Thu Mar 03 2022 04:21:18 GMT+0000 (UTC))
datadir:
modules: admin:1.0 clique:1.0 debug:1.0 eth:1.0 miner:1.0 net:1.0 personal:1.0 rpc:1.0 txpool:1.0 web3:1.0
To exit, press ctrl-d or type exit
>
```
Transfer funds to an address:
```bash
> eth.sendTransaction({from:eth.coinbase, to:"0x62c1831A63069619EE94d73853C21ceD076d0665", value: web3.toWei(125, "ether")})
```
## connect via Metamask
First, port-forward RPC
```bash
make port-forward-rpc
Forwarding from 127.0.0.1:8545 -> 8545
Forwarding from [::1]:8545 -> 8545
Handling connection for 8545
Handling connection for 8545
Handling connection for 8545
Handling connection for 8545
Handling connection for 8545
Handling connection for 8545
Handling connection for 8545
Handling connection for 8545
Handling connection for 8545
```
Metamask Chrome extension can be configured to connect to this network.
> Note that Metamask smartphone app will not accept http only RPC addresses
> and therefore in such cases only Chrome extensions can be used.
> See more: https://github.com/MetaMask/metamask-mobile/issues/2314#issuecomment-1013680137
Connection parameters, typically already setup as `Localhost` network:
* RPC: http://127.0.0.1:8545
* ChainID: 1337
* Currency symbol: ETH
At this point the funds transferred in previous should be visible in the Metamask wallet
assuming you have configured Metamask with the same address.
## linux and arm64 users:
First set env. var `PROJECT` to point to Google cloud project ID.
Also make sure you have artifact registry API enabled and a repo called
`services` has been provisioned for container images to reside in it.
`podman` can be used instead of `docker` to build and push multi-arch container
images. First build `amd64` and `arm64` images separately on respective host machines
with these host architectures.
```bash
make podman-build
```
Save/load container images and make sure both `amd64` and `arm64` images are
present on the same machine for next step to link them togehter in a manifest.
```bash
make podman-push
```
This will push the container images to your registry and link them in a manifest.
## references:
* https://geth.ethereum.org/docs/getting-started/dev-mode
* https://dev.to/blockchain_dev/getting-started-with-ethereum-connecting-geth-remix-and-metamask-for-local-development-ce1