[{"_1":2,"_187":-5,"_188":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_162":163},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":17},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":85,"_106":107,"_153":-5,"_154":11,"_155":17,"_156":11,"_157":-5,"_158":11,"_159":-5,"_160":161},"canonicalUrl","https://hub.docker.com/r/containersol/timber/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","containersol","reponame","timber","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2019-01-25T13:13:10.00793Z","description","","is_private","last_updated","2020-07-14T18:32:10.876477Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",584,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# Timber - the Training companion app\n\nHey there! This is Timber.\n\nTimber is a companion app for the [ContainerSolutions trainings](https://training.container-solutions.com/?utm_source=timber_docs).\n\nIts aim is to provide with engineers attending the trainings with a sample\napplication they can build upon and play with during the trainings.\n\nIt replicates a \"traditional web app\" setup where there is a frontend, a backend and a database (we'll use Redis).\n\nFunctionality is enabled & disabled mostly through environment variables.\n\nTimber is written in Python 3. Fear not! It is, we hope, well-documented and fairly easy to understand.\n\n- [Timber - the Training companion app](#timber---the-training-companion-app)\n - [💻 Running it locally](#%F0%9F%92%BB-running-it-locally)\n - [🚀 Running it on Kubernetes](#%F0%9F%9A%80-running-it-on-kubernetes)\n - [🐉 Backend](#%F0%9F%90%89-backend)\n - [`/api/v1/fortune`](#apiv1fortune)\n - [`/api/v1/metadata`](#apiv1metadata)\n - [`/api/v1/configuration`](#apiv1configuration)\n - [`/api/v1/colors`](#apiv1colors)\n - [`/api/v1/redis_detection`](#apiv1redisdetection)\n - [`/api/v1/state`](#apiv1state)\n - [💎 Frontend](#%F0%9F%92%8E-frontend)\n - [`/`](#)\n - [`configuration.py`](#configurationpy)\n - [`backend.py`](#backendpy)\n\n## 💻 Running it locally\n\nPretty straightforward! - `$ docker-compose up`\n\nEditing any `.py` files will make the application reload with your changes.\n\n## 🚀 Running it on Kubernetes\n\nSome manifests are provided for you in the [`manifests/`](manifests/) folder.\n\nThere are different ways to set this up, namely, you could at least:\n\n- Run the backend alone\n- Run the backend and the frontend in the same pod\n- Run the backend and the frontend in different pods, accessing each other with services\n- Run the frontend, backend and redis in different pods, accessing each other with services\n- Run the frontend, backend and redis in the same pod\n\nAnd many more!\n\n## 🐉 Backend\n\nThe backend is an API exposing data through HTTP endpoints.\n\nThey are all GET endpoints for simplicity.\n\nSome endpoints have a `description` value to pass a human readable sentence to the frontend.\n\nThe entrypoint of the API is [`app.py`](backend/app.py).\n\n### [`/api/v1/fortune`](backend/app.py)\n\nReturns a fortune cookie read from a file on a volume. This file is generated by a separate container. See `manifests/backend/solutions/deploy-volume.yml`\n\n### [`/api/v1/metadata`](backend/metadata.py)\n\nThe metadata is gathered mostly through the [Kubernetes downward API](https://kubernetes.io/docs/tasks/inject-data-application/environment-variable-expose-pod-information/).\n\nThese environment variables are read, defaulting to `unknown` if empty:\n\n- `MY_POD_NAME`\n- `MY_POD_IP`\n- `MY_POD_NAMESPACE`\n- `MY_NODE_NAME`\n\nThis API returns this data in JSON:\n```\n{\n description: <...>,\n hostname: <...>, # container hostname\n ip: <...>, # IP from the downward API\n namespace: <...>, # namespace from the downward API\n node: <...>, # node from the downward API\n pod: <...> # pod from the downward API\n}\n```\n\n### [`/api/v1/configuration`](backend/configuration.py)\n\nThis API endpoint returns the configuration of Timber.\n\nThis is set through environment variables.\n\n| Environment Variable | What it does | Default |\n|--------------------------------|-------------------|---------|\n| `TIMBER_LIVENESS_PROBE_ENABLED` | Set to any value to enable `/probe/liveness` | Disabled |\n| `TIMBER_READINESS_PROBE_ENABLED` | Set to any value to enable `/probe/readiness` | Disabled |\n| `TIMBER_VERSION` | Currently running application version | v1.0 |\n| `TIMBER_REDIS_HOST` | Redis server used if state is set to `redis` | `redis` |\n| `TIMBER_STATE` | State storage: `inmemory`, `redis` | `inmemory` |\n| `TIMBER_LISTEN_PORT` | Set the port Timber listens on | 8080 |\n\n\n```\n{\n description: <...>,\n liveness_probe_enabled: ,\n readiness_probe_enabled: ,\n redis_host: <...>,\n state: <...>,\n version: <...>\n}\n```\n\n### [`/api/v1/colors`](backend/colors.py)\n\nThis API endpoint returns deterministic hex colors.\n\nColors are generated based on the values of `TIMBER_VERSION`, `TIMBER_HOSTNAME`, `TIMBER_STATE`.\n\n```\n{\n hostname: <...>,\n state: <...>,\n version: <...>\n}\n```\n\n### [`/api/v1/redis_detection`](backend/redis_detection.py)\n\nThis API endpoint tells you whether Redis is detected in the same pod.\n\nIt works by trying to connect to Redis on `localhost`, and since pods share networking, this would work if Redis is running alongside the backend.\n\n```\n{\n description: <...>,\n is_detected: \n}\n```\n\n### [`/api/v1/state`](backend/state.py)\n\nThis API returns informations about the state kept by the backend.\n\n```\n{\n type: ,\n image_link: <...> # The picture we are keeping in state\n state_hits: # Number of times the state has been checked\n}\n```\n\n## 💎 Frontend\n\nThe frontend shows all the data that the backend provides, and some more.\n\nData from all the backend APIs is used, as well as showing the frontend hostname.\n\n### [`/`](frontend/app.py)\n\nThis is the frontend index. It uses [index.html](frontend/index.html) as a template,\nand gets the data from the backend API.\n\n### [`configuration.py`](frontend/configuration.py)\n\nFrontend configuration, through environment variables\n\n| Environment Variable | What it does | Default |\n|--------------------------------|---------------------|----------------------|\n| `TIMBER_BACKEND_API_URL` | Set the backend URL | `http://backend:8080`\n| `TIMBER_LISTEN_PORT` | Set the port Timber listens on | 8080 |\n\n### [`backend.py`](frontend/backend.py)\n\nThis file contains a `get_api()` helper function to get data as dictionary from the backend API endpoints.\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",151232820,"orgData",{"_86":87,"_88":89,"_90":91,"_92":29,"_93":44,"_94":95,"_96":97,"_98":99,"_100":101,"_102":44,"_103":44,"_104":44,"_105":17},"id","38d9744474c111e4bea40242ac11001b","uuid","38d97444-74c1-11e4-bea4-0242ac11001b","type","organization","orgname","full_name","location","Amsterdam","company","Container Solutions","profile_url","http://container-solutions.com/","date_joined","2014-11-14T13:53:08.105798Z","gravatar_url","gravatar_email","badge","is_active","recentTags",[108,144],{"_109":40,"_110":111,"_112":113,"_86":114,"_115":116,"_46":133,"_134":111,"_135":29,"_136":52,"_53":137,"_138":139,"_140":124,"_141":133,"_142":62,"_143":17},"content_type","creator",145492,"full_size",33350280,45144906,"images",[117],{"_118":119,"_120":121,"_122":44,"_123":124,"_125":126,"_127":128,"_129":44,"_130":-5,"_131":113,"_59":62,"_132":-5},"architecture","amd64","digest","sha256:b9a7ff404a75186d495a1e937cca16bb06d4e7dc3689fe9cac62e33521bc28ea","features","last_pulled","2026-09-28T02:25:59.724082703Z","last_pushed","2020-07-14T13:35:01Z","os","linux","os_features","os_version","size","variant","2020-07-14T18:32:10.540752Z","last_updater","last_updater_username","media_type","frontend","repository",6600138,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_109":40,"_110":111,"_112":145,"_86":146,"_115":147,"_46":151,"_134":111,"_135":29,"_136":52,"_53":152,"_138":139,"_140":150,"_141":151,"_142":62,"_143":17},34037604,45144735,[148],{"_118":119,"_120":149,"_122":44,"_123":150,"_125":126,"_127":128,"_129":44,"_130":-5,"_131":145,"_59":62,"_132":-5},"sha256:d701e84c3fbbd8dd80b5b928a81c5c1ab049fccbbc6e0650680d9f9f407b2591","2026-09-28T02:25:59.797587466Z","2020-07-14T18:32:06.557242Z","backend","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":164,"_171":172,"_160":185,"_186":11},{"_36":165,"_38":166,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":167,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":168,"_75":11,"_76":170,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":169},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_173":174,"_175":-5,"_176":-5,"_177":178},"count",2,"next","previous","results",[179,182],{"_109":40,"_110":111,"_112":113,"_86":114,"_115":180,"_46":133,"_134":111,"_135":29,"_136":52,"_53":137,"_138":139,"_140":124,"_141":133,"_142":62,"_143":17},[181],{"_118":119,"_120":121,"_122":44,"_123":124,"_125":126,"_127":128,"_129":44,"_130":-5,"_131":113,"_59":62,"_132":-5},{"_109":40,"_110":111,"_112":145,"_86":146,"_115":183,"_46":151,"_134":111,"_135":29,"_136":52,"_53":152,"_138":139,"_140":150,"_141":151,"_142":62,"_143":17},[184],{"_118":119,"_120":149,"_122":44,"_123":150,"_125":126,"_127":128,"_129":44,"_130":-5,"_131":145,"_59":62,"_132":-5},[],"canDeleteTags","actionData","errors"]

containersol/timber

Tags for containersol/timber