How to demo ZIM files?

[kelson42]

We need to create instances to demo new ZIM files:

• without having to publish them publicaly on library.kiwix.org
• without mixing them with other ZIM files
• on a speedy server
• easy to deploy and destroy
• only short live instances: 1-2 months

[kelson42]

The docker image of kiwix server is able to download a ZIM file. So we just need to start it wirh right argument to have an instance. We were able to do that easily with sloopy... maybe we could achieve to do something similar with an other provider?

[rgaudin]

Looks like you've ruled out using our own infra for some reason

[benoit74]

Some questions:

• does the ZIM must be served from a kiwix.org subdomain (are random names ok?)
• does the tool must auto-destroy the instance on given date (with a possibility to postpone, but by default a given date is set where the instance will be destroyed, otherwise we will have tens of hundreds of instances)
• does the tool to demo a new ZIM must be accessible to editors without developers involvement
• does the tool must be able to serve multiple ZIMs from one single kiwix-serve instance

[rgaudin]

Following today's discussion, we'll investigate first how to deploy it on our current infra.

• single domain (demo.openzim.org?)
• single kiwix-serve
• single varnish
• kiwix-serve home page hidden (rewritten by cache) so users can only access ZIM via full URL
• wildcard entry for *.<domain>
• automatic redirection from <xxx>.<domain> to <domain>/viewer#<xxx>. Should we redirect or serve in-place?

Main objective being that partners are given a single URL that leads only to the content we want them to look at.

[benoit74]

@Popolechien would this be a suitable replacement for links you currently send to partners on dev.library.kiwix.org?

Do you have any feedback to share on the questions I asked in previous comment?

I have a proposition of enhancement to what is reported by rgaudin (could be done in a second step): do we have a simple way to showcase the ZIM logo, title, description and long description on the partner "home page"? Quite important to check this as well from my experience so far.

Maybe a small tool that generate proper HTML with Jinja2 could do the job of properly configuring things (varnish and kiwix-serve) and destroying them when not needed anymore. We could even imagine to have one custom page per partner with all their ZIMs, could be helpful.

[Popolechien]

Not opinion on the wildcard part but we could simply decide that any new zim produced would overwrite the previous one.

@benoit74 Not sure I understand what your proposal entails that we don't already have, but if it is related to sending people to a library dashboard so they see their single card and then need to click to see the actual content (kind of like this), yes I would consider this a requirement.

[kelson42]

• wildcard entry for *.<domain>
• automatic redirection from <xxx>.<domain> to <domain>/viewer#<xxx>. Should we redirect or serve in-place?

Yes, even if I don't really get the added value. Does not really seems necessary because if there is no home page, each ZIM is properly isolated from the others already.

It should be really easy to setup/remove a ZIM file from there, so it can be requested directly via chat and made within a few minutes.