= Background information
~~With the upcoming task {T210704}.We were previously able to work around some version dependencies and run Kartotherian on Node 10, Tilerator and Kartotherian need to upgrade some libraries to be compatible with node 10.~~
UPDATE: We were able to run Kartotherian/Tilerator on a Node 10 setupby using a [[ https://www.npmjs.com/package/@kartotherian/mapnik | custom node-mapnik ]] versionbuild deployed under the kartotherian GitHub org.
In order to get back to the upstream providernode-mapnik package, we should still wait for we need to update libmapnik v3to 3.1.x to be released, more info below.x
= What
>>! In T209990#4787851, @Mholloway wrote:
> Node 10 is only supported in node-mapnik >= 4.0.0.
>
> https://github.com/mapnik/node-mapnik/blob/master/CHANGELOG.md#400
Also, node-mapnik >= 4.0.0 works with the pre-release master branch of mapnik. That means that the migration will be blocked until mapnik v3.1.x is released (which is an ongoing work since mid-2017). When it happens, tThe following dependencies needs to upgrade node-mapnik to the latest version:
- mapbox/tilelive-bridge
- kartotherian/tilelive-vector
- kartotherian/tilelive-tmsource
- kartotherian/abaculus
- kartotherian/snapshot
- kartotherian/maki
Still, whatWhat could be tested so far indicates that one third-party dependency also needs to be improved whenfor mapnik v3.1.x will be released, and that is [[ https://github.com/mapnik/mapnik-reference | mapnik-reference ]], which doesn't support the pre-releasenew schema yet.
= How
Upgrade the libraries when the time comes.
[ ] mapbox/tilelive-bridge (wait for upstream or fork if it's no longer maintained)
[ ] kartotherian/tilelive-vector (https://github.com/kartotherian/tilelive-vector/pull/4)
[ ] kartotherian/tilelive-tmsource (https://github.com/kartotherian/tilelive-tmsource/pull/2)
[ ] kartotherian/abaculus (https://github.com/kartotherian/abaculus/pull/3)
[ ] kartotherian/snapshot (https://github.com/kartotherian/snapshot/pull/20)
[ ] kartotherian/maki (https://github.com/kartotherian/maki/pull/4)
= Open questions
Is that going to be a straight forward upgrade for our dependencies? Some libraries we use are outdated and upgrade them might bring incompatibilities, this will need more tests when mapnik v3.1.x is available.
= Acceptance criteria
- [] Backport to Debian stretch mapnik v3.1.x when released
- [] Wait for mapnik-reference to be updated on upstream
- [] Upgrade node-mapnik in all dependencies
- [] Test and deploy