Upgrading docker image from 20.4.8.99 to latest (21.11.8.4)

[ervin...@gmail.com]

Hey guys, is it safe to upgrade our docker image of ClickHouse from version 20.4.8.99 to the latest tag 21.11.8.4?

Are there any back compatibility issues that we should be aware of or any procedures we need to take care manually before the upgrade?

Could not find any info in the docs about this so any input is really appreciated.

[ervin...@gmail.com]

Quick update:

The upgrade overall went through without any issues but the only thing that is not working is the substitution for remote_servers:

   <remote_servers incl="clickhouse_remote_servers">
       
    </remote_servers>

Anyone aware of issues with the substitution format in the latest versions of ClickHouse? Right now remote_servers definition is being overwritten with the default definition from : /etc/clickhouse-server/config.xml

The substitution for zookeeper is working correctly, so this adds to the weirdness of the issue:

    <zookeeper incl="zookeeper-servers" optional="true" />

My metrica.xml file is defined like this:

<yandex>
    <clickhouse_remote_servers>   
        <single_shard_3_replicas>
            <shard>
                <replica>
                    <host>clickhouse3</host>
                    <port>9000</port>
                </replica>
                <replica>
                    <host>clickhouse4</host>
                    <port>9000</port>

                </replica>
                <replica>
                    <host>clickhouse5</host>
                    <port>9000</port>
                </replica>

            </shard>

        </single_shard_3_replicas>
    </clickhouse_remote_servers>


    <zookeeper-servers>
        <node>
            <host>zoo3</host>
            <port>2181</port>
        </node>
        <node>
            <host>zoo4</host>
            <port>2181</port>
        </node>
        <node>
            <host>zoo5</host>
            <port>2181</port>
        </node>

    </zookeeper-servers>

    <macros>
        <shard>01</shard>
        <replica>serv5</replica>
    </macros>

</yandex>

[Denis Zhuravlev]

https://github.com/ClickHouse/ClickHouse/issues/21905

https://kb.altinity.com/altinity-kb-setup-and-maintenance/altinity-kb-server-config-files/

[ervin...@gmail.com]

Thank you Denis, that fixed the issue.