{"id":15104938,"url":"https://github.com/merll/docker-fabric","last_synced_at":"2025-12-30T09:07:12.242Z","repository":{"id":20127412,"uuid":"23397427","full_name":"merll/docker-fabric","owner":"merll","description":"Integration of Docker deployments into Fabric.","archived":true,"fork":false,"pushed_at":"2020-04-30T22:17:14.000Z","size":269,"stargazers_count":79,"open_issues_count":6,"forks_count":10,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-12-17T07:57:01.399Z","etag":null,"topics":["docker","docker-client","docker-containers","dockerfile","fabric","python"],"latest_commit_sha":null,"homepage":"","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":"2014-08-27T16:40:52.000Z","updated_at":"2023-09-07T07:49:09.000Z","dependencies_parsed_at":"2022-09-01T01:21:33.501Z","dependency_job_id":null,"html_url":"https://github.com/merll/docker-fabric","commit_stats":null,"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/merll%2Fdocker-fabric","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/merll%2Fdocker-fabric/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/merll%2Fdocker-fabric/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/merll%2Fdocker-fabric/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/merll","download_url":"https://codeload.github.com/merll/docker-fabric/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234376917,"owners_count":18822416,"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":["docker","docker-client","docker-containers","dockerfile","fabric","python"],"created_at":"2024-09-25T20:04:24.464Z","updated_at":"2025-09-27T02:32:39.283Z","avatar_url":"https://github.com/merll.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Docker-Fabric\n=============\n\nBuild Docker images, and run Docker containers in Fabric.\n---------------------------------------------------------\n\nProject: https://github.com/merll/docker-fabric\n\nDocs: https://docker-fabric.readthedocs.io/en/latest/\n\n\nOverview\n========\nWith a few preparations, Docker images can easily be generated and tested on development\nmachines, and transferred on to a production environment. This package supports managing\ncontainer configurations along with their dependencies within Fabric-based deployments.\nDockerFiles can also be easily implemented in Fabric tasks.\n\nLocal Docker clients can be controlled directly through ``docker-py``. Remote Docker\nAPI services make use of Fabric's SSH connection.\n\nAPI access\n==========\nThis project is based on [Docker-Map](https://github.com/merll/docker-map), and adapts\nits container configuration methods.\n\nAs with Docker-Map, container configurations can be generated as objects, updated from\nPython dictionaries, or imported from YAML files in order to control remote clients\nvia the API. Docker-Fabric includes the following enhancements:\n\nDocker client\n-------------\n`DockerFabricClient` adds Fabric-like logging in the context of container instances on\ntop of Fabric hosts, and enables automatic creation of tunnel connections for access to a\nremote Docker host using Fabric's SSH connection. By using the tool `socat`, the Docker\nclient can access a remote service without re-configuration.\n\nClient configuration\n--------------------\n`DockerClientConfiguration` adds the capability of running containers to Fabric hosts\nwith specific Docker settings for each, e.g. the version number.\n\nRunning container configurations\n--------------------------------\n`ContainerFabric` is a simple wrapper that combines Docker-Map's `DockerFabricClient`,\n`DockerClientConfiguration` objects, and container maps.\n\nCommand-line based access\n-------------------------\nThe following features are provided by running the appropriate commands on a remote Docker\ncommand line:\n\n* Copy resources from a container to a Fabric host.\n* Copy resources from a container and download them in a compressed tarball. The Docker\n  Remote API currently does not support creating compressed tarballs.\n* Copy resources from a container and store them in a new blank image.\n* Generate a compressed image tarball. The Docker Remote API currently does not support\n  creating compressed tarballs, but is capable of importing them.\n\nTasks\n=====\nAll essential container actions (`create`, `start`, `stop`, `remove`) and some advanced\n(e.g. `update`) can be triggered from the command line as Fabric tasks and executed on\nthe remote service, e.g. via SSH.\n\nAdditionally the following tasks are included in this package, that can be run by Fabric\ndirectly:\n\n* `check_version`: Returns version information of the remote Docker service and provides\n  useful insight if permissions are set up properly.\n* `cleanup_containers`: Removes all containers that have stopped.\n* `cleanup_images`: Removes all untagged images, that do not have a dependent container\n  or other dependent images.\n* `remove_all_containers`: Stops and removes all containers on the remote Docker service.\n\n\nContributions\n=============\nThanks to [lfasnacht](https://github.com/lfasnacht) for publishing an implementation for\na local tunnel to a Fabric client in the [pull request 939 of Fabric](https://github.com/fabric/fabric/pull/939).\n\nFurther contributions are maintained in [CONTRIBUTIONS.md](https://github.com/merll/docker-fabric/blob/master/CONTRIBUTIONS.md) of the project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmerll%2Fdocker-fabric","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmerll%2Fdocker-fabric","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmerll%2Fdocker-fabric/lists"}