36 Commits

Author SHA1 Message Date
17d9ecd1ce feat: (fake release trigger) Bump default EN to v27.2.0 (#41)
## What 

Subj

## Why 

Due to incorrect repo merge settings it was allowed to merge without
squash so commits went to main without semver prefixes and did not
trigger release

## Checklist

<!-- Check your PR fulfills the following items. -->
<!-- For draft PRs check the boxes as you complete them. -->

- [x] PR title corresponds to the body of PR (we generate changelog
entries from PRs).
- [ ] Documentation comments have been added / updated.
2025-04-25 12:23:39 +02:00
5071bb3423 Merge pull request #39 from matter-labs/update_27.2.0
feat: update default EN version to 27.2.0
2025-04-25 12:05:28 +02:00
fa4f00a62d Merge pull request #40 from matter-labs/consensus-debug-port
feat: Consensus debug config
2025-04-25 12:04:08 +02:00
f3ce6ce204 feat: Consensus debug config 2025-04-25 11:51:05 +02:00
cd5df40065 update EN versio to 27.2.0 2025-04-24 13:08:43 +03:00
4bd3805af1 Merge pull request #38 from matter-labs/docs
Some checks failed
Release / Release (push) Has been cancelled
CI / Lint (push) Has been cancelled
CI / Ansible lint (push) Has been cancelled
chore(docs): Update link to EN mainnet DB backup
2024-12-16 17:45:26 +07:00
8006ed9328 chore(docs): Update link to EN mainnet backup 2024-12-16 17:38:02 +07:00
c497fc0982 Merge pull request #37 from matter-labs/yorik-patch-1
Some checks failed
Release / Release (push) Has been cancelled
CI / Lint (push) Has been cancelled
CI / Ansible lint (push) Has been cancelled
feat: Fake PR to force release
2024-12-04 15:49:30 +01:00
57f3fb74e4 feat: Fake PR to force release 2024-12-04 15:47:39 +01:00
aa018348d8 Merge pull request #36 from matter-labs/gprusak-rate-limit
feat(consensus): bumped inbound connections limit
2024-12-04 15:04:28 +01:00
b8e3b89cf5 bumped inbound connections limit 2024-12-03 17:47:46 +01:00
d276d7b290 Merge pull request #35 from matter-labs/backup-user
Some checks failed
Release / Release (push) Has been cancelled
CI / Lint (push) Has been cancelled
CI / Ansible lint (push) Has been cancelled
feat: Added user with backup permissions only
2024-11-27 15:45:36 +01:00
60333c40da feat: Added user with backup permissions only 2024-11-27 15:24:20 +01:00
2eb2b1f6d4 feat: Added user with backup permissions only 2024-11-27 15:12:12 +01:00
69777ac4e8 feat: Added user with backup permissions only 2024-11-27 15:08:46 +01:00
46e2a6e0e4 feat: Added user with backup permissions only 2024-11-27 14:51:33 +01:00
c5ab63672b Merge pull request #34 from matter-labs/add-more-replication
Some checks failed
Release / Release (push) Has been cancelled
CI / Lint (push) Has been cancelled
CI / Ansible lint (push) Has been cancelled
feat: Configure replication from postgres collection
2024-11-20 18:04:24 +01:00
22a1d06ef7 fix lint 2024-11-20 17:59:52 +01:00
655b461ba5 add libpq-dev 2024-11-20 17:55:22 +01:00
45feed1069 add psycopg2 2024-11-20 17:51:20 +01:00
5298e9f87d add psycopg2 2024-11-20 17:48:55 +01:00
576f8eb252 change priv to role_attr_flags 2024-11-20 17:44:12 +01:00
b672d803f0 fixed lint 2024-11-20 17:01:52 +01:00
5e8657ac3b fixed lint 2024-11-20 17:00:14 +01:00
4f1b6a37ab fixed lint 2024-11-20 16:59:27 +01:00
9034dc5fd4 feat: Configure replication from postgres collection 2024-11-20 16:42:58 +01:00
dac0b0cc80 feat: Configure replication from postgres collection 2024-11-20 16:37:33 +01:00
10ea272736 Merge pull request #33 from matter-labs/fix-type-postgres_replication_interface
fix: Rename variable postgres_replication_bind_address
2024-11-20 10:41:23 +01:00
3fa5c8622b fix: Rename variable postgres_replication_bind_address 2024-11-20 10:40:16 +01:00
64198202a5 Merge pull request #32 from matter-labs/fix-typo
fix: Fixed typo in validation step for replication
2024-11-20 10:36:36 +01:00
0d1717f38a fix: Fixed typo in validation step for replication 2024-11-20 10:35:18 +01:00
13ef869339 Merge pull request #31 from matter-labs/add-replication-vars
Some checks are pending
Release / Release (push) Waiting to run
feat: Added optional postgres replication
2024-11-19 16:35:45 +01:00
cfbaed74f0 Added replication flags 2024-11-19 16:28:13 +01:00
6f1e025785 Added replication flags 2024-11-19 16:26:57 +01:00
f347a9173e feat: Added optional postgres replication 2024-11-19 16:12:31 +01:00
2bf98e9273 feat: Added optional postgres replication 2024-11-19 16:11:28 +01:00
10 changed files with 132 additions and 13 deletions

View File

@ -99,10 +99,10 @@ Basic auth secret can be generated by `htpasswd` and `sed` for interpolation:
2. Prepare the latest database backup on your host. you can download it from our public GCS buckets: 2. Prepare the latest database backup on your host. you can download it from our public GCS buckets:
Skip this step if you are recovering from a snapshot! Skip this step if you are recovering from a snapshot!
* [Era Mainnet latest dump](https://storage.googleapis.com/zksync-era-mainnet-external-node-backups/external_node_latest.pgdump) * [Era Mainnet latest dump](https://en-backups.matterlabs.dev/)
* [Era Sepolia Testnet latest dump](https://storage.googleapis.com/zksync-era-testnet-sepolia-external-node-backups/external_node_latest.pgdump) * [Era Sepolia Testnet latest dump](https://storage.googleapis.com/zksync-era-testnet-sepolia-external-node-backups/external_node_latest.pgdump)
Downloaded dump file should be placed into `{{ storage_directory }}/pg_backups` directory (`/usr/src/en/pg_backups` by default) Downloaded dump, if needed, should be unarchived and named `external_node_latest.pgdump`. File should be placed into `{{ storage_directory }}/pg_backups` directory (`/usr/src/en/pg_backups` by default).
3. **OPTIONAL**: If you already have running node, you can copy its tree and state directory to a new host's `{{ storage_directory }}/db`. (`/usr/src/en/db` by default) 3. **OPTIONAL**: If you already have running node, you can copy its tree and state directory to a new host's `{{ storage_directory }}/db`. (`/usr/src/en/db` by default)
Skip this step if you are recovering from a snapshot! Skip this step if you are recovering from a snapshot!

View File

@ -11,7 +11,7 @@ docker_compose_version: "v2.23.0"
# Versions of External Node and 3rd party components # Versions of External Node and 3rd party components
traefik_version: 2.11 traefik_version: 2.11
postgres_version: 14 postgres_version: 14
external_node_version: 24.26.0 external_node_version: 27.2.0
external_node_raw_docker_tag: "" external_node_raw_docker_tag: ""
vmagent_version: 1.100.1 vmagent_version: 1.100.1
cadvisor_version: 0.47.2 cadvisor_version: 0.47.2
@ -56,6 +56,17 @@ postgres_arguments:
- max_parallel_maintenance_workers=4 - max_parallel_maintenance_workers=4
- -c - -c
- checkpoint_timeout=1800 - checkpoint_timeout=1800
enable_postgres_replication: false
# IP address of the interface replication
postgres_replications_arguments: []
postgres_replica_user_name: ""
postgres_replica_user_password: ""
postgres_replica_auth_method: "scram-sha-256"
postgres_replication_bind_address: ""
postgres_replica_address: ""
backup_db_user: ""
backup_db_password: ""
backup_db_name: ""
# Enable TLS for traefik # Enable TLS for traefik
enable_tls: false enable_tls: false
@ -77,6 +88,8 @@ snapshots_bucket_base_url: ""
enable_consensus: false enable_consensus: false
consensus_secrets_file: "" consensus_secrets_file: ""
consensus_port: 3054 consensus_port: 3054
consensus_debug_port_enabled: false
consensus_debug_port: 5000
consensus_outbound: [] consensus_outbound: []
# External Node and database options # External Node and database options

View File

@ -8,16 +8,16 @@ To run this playbook, first install dependencies
```shell ```shell
ansible-galaxy install -r requirements.yml ansible-galaxy install -r requirements.yml
``` ```
and then you can run the playbook using and then you can run the playbook using
```shell ```shell
ansible-playbook playbook.yml -i hosts.ini -K ansible-playbook playbook.yml -i hosts.ini -K
``` ```
To see logs you can use To see logs you can use
```shell ```shell
docker logs en-external_node-1 docker logs en-external_node-1
``` ```

View File

@ -10,3 +10,6 @@ roles:
collections: collections:
- name: community.general - name: community.general
version: 8.4.0 version: 8.4.0
# Collection for the replication only.
- name: community.postgresql
version: 3.7.0

View File

@ -57,6 +57,15 @@
destination_port: "{{ consensus_port }}" destination_port: "{{ consensus_port }}"
jump: ACCEPT jump: ACCEPT
- name: Allow postgres replication traffic from replica only
when: enable_postgres_replication
ansible.builtin.iptables:
chain: INPUT
protocol: tcp
destination_port: 5432
source: "{{ postgres_replica_address }}"
jump: ACCEPT
- name: Set default policy to DROP - name: Set default policy to DROP
ansible.builtin.iptables: ansible.builtin.iptables:
chain: INPUT chain: INPUT

View File

@ -9,3 +9,7 @@
- name: Prepare configs - name: Prepare configs
ansible.builtin.include_tasks: provision.yml ansible.builtin.include_tasks: provision.yml
- name: Configure replication on main instance
ansible.builtin.include_tasks: replication.yml
when: enable_postgres_replication

View File

@ -32,6 +32,23 @@
- l2_chain_id - l2_chain_id
- l1_chain_id - l1_chain_id
- name: "Verify that required variables for replication is set"
when: enable_postgres_replication
ansible.builtin.assert:
that:
- postgress_replication_required_var != ""
fail_msg: "{{ postgress_replication_required_var }} needs to be set for the role for postgres replication to work"
success_msg: "Required variable for postgres replication {{ postgress_replication_required_var }} isn't empty"
loop_control:
loop_var: postgress_replication_required_var
with_items:
- enable_postgres_replication
- postgres_replication_bind_address
- postgres_replica_address
- postgres_replications_arguments
- postgres_replica_user_name
- postgres_replica_user_password
- name: Check required en vars empty - name: Check required en vars empty
ansible.builtin.fail: ansible.builtin.fail:
msg: "Variable '{{ item }}' is empty" msg: "Variable '{{ item }}' is empty"

60
tasks/replication.yml Normal file
View File

@ -0,0 +1,60 @@
---
- name: Install libpq-dev packages
ansible.builtin.apt:
update_cache: true
name: libpq-dev
- name: Install psycopg2 python package
ansible.builtin.pip:
name: psycopg2
- name: Grant user replication access for replication.
community.postgresql.postgresql_pg_hba:
dest: "{{ storage_directory }}/postgres/pg_hba.conf"
contype: host
users: "{{ postgres_replica_user_name }}"
source: "{{ postgres_replica_address }}/32"
databases: replication
method: "{{ postgres_replica_auth_method }}"
- name: Create postgres replication user
community.postgresql.postgresql_user:
login_host: "{{ postgres_replication_bind_address }}"
login_user: "{{ database_username }}"
login_password: "{{ database_password }}"
name: "{{ postgres_replica_user_name }}"
password: "{{ postgres_replica_user_password }}"
role_attr_flags: "REPLICATION"
- name: Create replication slot if doesn't exist
community.postgresql.postgresql_slot:
login_host: "{{ postgres_replication_bind_address }}"
login_user: "{{ database_username }}"
login_password: "{{ database_password }}"
slot_name: replica
- name: Reload postgres configuration
community.postgresql.postgresql_query:
login_host: "{{ postgres_replication_bind_address }}"
login_user: "{{ database_username }}"
login_password: "{{ database_password }}"
query: "SELECT pg_reload_conf()"
- name: Create postgres backup user
community.postgresql.postgresql_user:
login_host: "{{ postgres_replication_bind_address }}"
login_user: "{{ database_username }}"
login_password: "{{ database_password }}"
name: "{{ backup_db_user }}"
password: "{{ backup_db_password }}"
- name: Grant role pg_read_all_data to backup user
community.postgresql.postgresql_membership:
login_host: "{{ postgres_replication_bind_address }}"
login_user: "{{ database_username }}"
login_password: "{{ database_password }}"
group: pg_read_all_data
target_roles:
- "{{ backup_db_user }}"
state: present

View File

@ -1,9 +1,13 @@
server_addr: '0.0.0.0:3054' server_addr: '0.0.0.0:3054'
public_addr: '{{ ansible_default_ipv4.address }}:{{ consensus_port }}' public_addr: '{{ ansible_default_ipv4.address }}:{{ consensus_port }}'
max_payload_size: 5000000 max_payload_size: 5000000
gossip_dynamic_inbound_limit: 100 gossip_dynamic_inbound_limit: 200
gossip_static_outbound: {% if consensus_debug_port_enabled %}
{% for item in consensus_outbound %} debug_page_addr: "0.0.0.0:{{ consensus_debug_port }}"
- key: {{ item.key }} {% endif %}
addr: {{ item.addr }} rpc_config:
{% endfor %} get_block_rate:
burst: 5
refresh: # 0.2s
seconds: 0
nanos: 200000000

View File

@ -43,12 +43,21 @@ services:
- ./restore_dump.sh:/docker-entrypoint-initdb.d/restore_dump.sh - ./restore_dump.sh:/docker-entrypoint-initdb.d/restore_dump.sh
env_file: env_file:
- postgres.env - postgres.env
{% if enable_postgres_replication %}
ports:
- "{{ postgres_replication_bind_address }}:5432:5432"
{% endif %}
command: command:
- postgres - postgres
- -c - -c
{% for argument in postgres_arguments %} {% for argument in postgres_arguments %}
- {{ argument }} - {{ argument }}
{% endfor %} {% endfor %}
{% if enable_postgres_replication %}
{% for repl_argument in postgres_replications_arguments %}
- {{ repl_argument }}
{% endfor %}
{% endif %}
external_node: external_node:
{% if not external_node_raw_docker_tag %} {% if not external_node_raw_docker_tag %}
image: "matterlabs/external-node:v{{ external_node_version }}" image: "matterlabs/external-node:v{{ external_node_version }}"