{"id":15167159,"url":"https://github.com/merll/salt-container-map","last_synced_at":"2025-10-01T00:31:00.976Z","repository":{"id":34863144,"uuid":"38863690","full_name":"merll/salt-container-map","owner":"merll","description":"Configuration management and implicit dependency tracking for Docker containers in SaltStack.","archived":true,"fork":false,"pushed_at":"2018-01-16T16:52:27.000Z","size":119,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-12-13T23:05:34.050Z","etag":null,"topics":["configuration-management","docker","docker-container","saltstack"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/merll.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-07-10T05:58:41.000Z","updated_at":"2023-01-01T20:12:08.000Z","dependencies_parsed_at":"2022-08-08T02:01:27.816Z","dependency_job_id":null,"html_url":"https://github.com/merll/salt-container-map","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/merll%2Fsalt-container-map","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/merll%2Fsalt-container-map/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/merll%2Fsalt-container-map/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/merll%2Fsalt-container-map/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/merll","download_url":"https://codeload.github.com/merll/salt-container-map/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234796854,"owners_count":18888156,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["configuration-management","docker","docker-container","saltstack"],"created_at":"2024-09-27T05:40:44.250Z","updated_at":"2025-10-01T00:31:00.655Z","avatar_url":"https://github.com/merll.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Salt Container-Map\n==================\n\nConfiguration management and implicit dependency setup for Docker containers in SaltStack.\n------------------------------------------------------------------------------------------\n\nProject: https://github.com/merll/salt-container-map\n\nDocs: Basic usage is provided in the\n[state module](http://salt-container-map.readthedocs.io/en/latest/api/saltcontainermap.states.html).\nDetails about container\nconfigurations are available in the\n[docs for Docker-Map](https://docker-map.readthedocs.io/en/latest/guide/containers/maps.html#container-landscapes-with-containermap).\n\n\nOverview\n========\nThis package contains SaltStack modules for configuring Docker containers. They do not replace,\nbut complement Salt's built-in `dockerio` module in the following aspects:\n\n* Container dependencies that have to be followed during startup and shutdown do not have to be\n  modelled via `require` or `require_in`. Instead, these are implicitly defined through their \n  shared volumes and links.\n* For the purpose of sharing data between containers, virtual volumes can be created via a\n  minimal runnable image (`tianon/true` obtained from the public Docker registry). These are\n  considered during the dependency check and become adjusted with necessary file system permissions\n  during startup.\n* When the configuration of a container is modified, the affected containers and their dependents\n  can automatically be shut down and recreated.\n* Image updates can also result in an automated shutdown and recreation of containers and their\n  dependents, without explicit `watch` or `onchanges`.\n  \nAn example is documented in the state module.\n\nInstallation\n============\nBesides the usual package installation, a few simple post-installation steps are required. They are\ndescribed in the [docs](http://salt-container-map.readthedocs.io/en/latest/installation.html).\n\nModules\n=======\n\nCustom renderer\n---------------\nContainer configurations can be set in both pillars and states. Pillars have the advantage that\nthey are loaded automatically before any state (e.g. `container_map.updated`) or execution module\nuses it. Usually the disadvantage is that pillars cannot refer to other pillars. This package\nhowever provides a custom renderer `lazy_yaml` along with custom tags `!pillar` and  `!grain`,\nwhich are resolved to their values on the minion just before the container maps and their\nconfigurations are instantiated.\n\nBy default, container maps are loaded from a pillar `container_maps`. This can be changed in the\nconfiguration by setting the configuration value `container_map.pillar_name`.\n\nState and execution module\n--------------------------\nThe modules distributed to the minions provide the functionality as outlined in the overview.\nA usage example is included in the\n[state module documentation](http://salt-container-map.readthedocs.io/en/latest/api/saltcontainermap.states.html).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmerll%2Fsalt-container-map","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmerll%2Fsalt-container-map","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmerll%2Fsalt-container-map/lists"}