Thumbor/Runbook

Testing a specific thumbnail

In Thumbor staging, the pods are left in debug mode so there will be details of every step of the query logged. This means that staging is the best place to test library/image upgrades and also to debug images that are failing for whatever reason. Reading the logs for thumbor-8080 on staging will generally make it clear whether an image is somehow invalid (incorrect ICC profile, bad metadata, not meeting specifications of the format etc) or if there is an issue with thumbor or swift.

It is best to test a variety of formats if possible, especially if major changes have happened to a format that required the integration tests to be altered. In order to ensure we generate a new image, it is recommended to change the size of the image in question by specifying an arbitrary odd number for the px value in the path.

Some sample paths:

/wikipedia/commons/thumb/e/e5/NASA_logo.svg/574px-NASA_logo.svg.png
/wikipedia/commons/thumb/a/af/The_pedigree_of_Birkbeck_of_Mallerstang_and_Settle%2C_Braithwaite_of_Kendal%2C_Benson_of_Stang_End_(IA_cu31924032192811).pdf/page1-220px-The_pedigree_of_Birkbeck_of_Mallerstang_and_Settle%2C_Braithwaite_of_Kendal%2C_Benson_of_Stang_End_(IA_cu31924032192811).pdf.jpg

/wikipedia/commons/thumb/1/10/Star-Forming_%22Bubble%22_RCW_79.jpg/250px-Star-Forming_%22Bubble%22_RCW_79.jpg

/wikipedia/commons/thumb/8/83/3D_model_of_the_human_mouth.stl/1283px-3D_model_of_the_human_mouth.stl.png

These can be tested against staging using

curl http://staging.svc.eqiad.wmnet:8800/${IMG_PATH}

In production, appending these paths to https://upload.wikimedia.org will hit Thumbor directly.