Explain in CONTRIBUTING how to get started in conjunction with tileserver

[pnorman]

A lot of people (or at least myself) will come to tilequeue because it's used as a component of tileserver. IIt would be good to explain how to contribute to tilequeue when you're using it this way and don't run it independently.

[elwin-jacellc]

Bump!
Just the basics to get started will be nice. I.e. how to use tilequeue without tileserver to generate a set of tiles and store in file.

[rmarianski]

Just to get started, the easiest way would be to configure local implementations of queues and stores, run the seed command, and then run the process command.

Excerpt:

queue:
  type: file
  name: tiles-queue
store:
  type: directory
  name: tiles

Seed:

tilequeue seed --config config.yaml

Process:

tilequeue process --config config.yaml

Hopefully that can help get you started.

[elwin-jacellc]

Quick question when storing to s3, it currently stores to

<bucket>/<date prefix>/<hex value>/<path>/all/<z>/<x>/<y>

How do we get rid of the <hex value> part in the path?

[rmarianski]

Hhmm, that's in there as an optimization for working with s3. Having key prefixes differ earlier on is friendlier for it, see https://docs.aws.amazon.com/AmazonS3/latest/dev/request-rate-perf-considerations.html

If you really want it off, I'm afraid that there isn't a way to configure it off at the moment, but it's not a lot of work to add in support for it. Want to create an issue for it? If you're up for it, we'd gladly accept a pr as well. Here's the relevant bit of code.

[elwin-jacellc]

Thanks. We'll submit a pr.

[cyfugr]

Question about that, i am trying to run the tileque seed with the config that was mentioned above but i get an error saying that Missing queue name