History

Adw8 852db93b9e Move remote host setup to root README		2024-09-09 14:53:06 +05:30
..
templates	Add ansible playbook to setup and run L2 deployment (#3 )	2024-09-05 07:58:00 +00:00
.gitignore	Add README steps to deploy nitro contracts on remote machine	2024-09-09 11:51:29 +05:30
l2-vars-example.yml	Add l2-vars-example file	2024-09-09 11:51:29 +05:30
README.md	Move remote host setup to root README	2024-09-09 14:53:06 +05:30
run-optimism.yml	Add ansible playbook to setup and run L2 deployment (#3 )	2024-09-05 07:58:00 +00:00
setup-vars.yml	Add README steps to setup and run L2 on remote machine	2024-09-09 11:51:29 +05:30

README.md

l2-setup

Setup Ansible

To get started, follow the installation guide to setup ansible on your machine

Setup for Remote Host

To run the playbook on a remote host:

Follow steps from setup remote hosts
Update / append the hosts.ini file for your remote host with <deployment_host> set as l2_host

Setup and Run Optimism

The following commands have to be executed in l2-setup directory

Copy the l2-vars-example.yml vars file
```
cp l2-vars-example.yml l2-vars.yml
```

Edit l2-vars.yml with the required values

# L1 chain ID
l1_chain_id: ""

# L1 RPC endpoint
l1_rpc: ""

# L1 RPC endpoint host or IP address
l1_host: ""

# L1 RPC endpoint port number
l1_port: ""

# L1 Beacon endpoint
l1_beacon: ""

# Address of the funded account on L1
# Used for optimism contracts deployment
l1_address: ""

# Private key of the funded account on L1
l1_priv_key: ""

To setup and run L2, execute the run-optimism.yml Ansible playbook by running one of the following commands:
- For local deployment, specify the "target_host": localhost in the --extra-vars parameter:
```
LANG=en_US.utf8 ansible-playbook run-optimism.yml --extra-vars='{ "target_host": "localhost"}' -kK --user $USER
```
- For remote deployment, provide an inventory and specify the "target_host": l2_host in the --extra-vars parameter:
```
LANG=en_US.utf8 ansible-playbook -i ../hosts.ini run-optimism.yml --extra-vars='{ "target_host": "l2_host"}' -kK
```
  NOTE: By default, deployments are created in a out directory. To change this location, update the l2_directory variable in the setup-vars.yml file.
- For skipping container build, set "skip_container_build" : true in the --extra-vars parameter:
```
LANG=en_US.utf8 ansible-playbook -i ../hosts.ini run-optimism.yml --extra-vars='{"target_host" : "l2_host", "skip_container_build": true}' -kK
```
To run using existing contracts deployment
- Update artifact_path in setup-vars.yml file with path to data directory of the existing deployment
- Run the ansible playbook with "existing_contracts_deployment": true in the --extra-vars parameter:
```
LANG=en_US.utf8 ansible-playbook -i ../hosts.ini run-optimism.yml --extra-vars='{"target_host" : "l2_host", "existing_contracts_deployment":  true}' -kK
```

Check Deployment Status

Run the following command in the directory where the optimism-deployment is created

Follow optimism contracts deployment logs:

laconic-so deployment --dir optimism-deployment logs -f fixturenet-optimism-contracts

Check L2 logs:

laconic-so deployment --dir optimism-deployment logs -f op-geth

# Ensure new blocks are getting created