testnet-ops/l2-setup/README.md
Prathamesh Musale e142357428 Add ansible playbook to setup and run L2 deployment (#3)
Part of [Automate testnet nitro deployments using Ansible](https://www.notion.so/Automate-testnet-nitro-deployments-using-Ansible-0d15579430204b8daba9a8aa31e07568)

Co-authored-by: Adw8 <adwaitgharpure@gmail.com>
Reviewed-on: #3
Co-authored-by: Prathamesh Musale <prathamesh@noreply.git.vdb.to>
Co-committed-by: Prathamesh Musale <prathamesh@noreply.git.vdb.to>
2024-09-05 07:58:00 +00:00

2.3 KiB

l2-setup

Setup Ansible

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

Setup and Run Optimism

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

  • 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 the following command.

    NOTE: By default, deployments are created in the l2-setup/out directory. To change this location, update the l2_directory variable in the setup-vars.yml file.

    LANG=en_US.utf8 ansible-playbook -i localhost, --connection=local run-optimism.yml --extra-vars='{ "target_host": "localhost"}' -kK --user $USER
    
    • For skipping container build, set "skip_container_build" : true in the --extra-vars parameter:

      LANG=en_US.utf8 ansible-playbook -i localhost, --connection=local run-optimism.yml --extra-vars='{"target_host" : "localhost", "skip_container_build": true}' -kK --user $USER
      
  • 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 localhost, --connection=local run-optimism.yml --extra-vars='{"target_host" : "localhost", "existing_contracts_deployment":  true}' -kK --user $USER
      

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