{"id":13416473,"url":"https://github.com/garywiz/chaperone-docker","last_synced_at":"2026-01-12T03:03:47.860Z","repository":{"id":33858834,"uuid":"37565291","full_name":"garywiz/chaperone-docker","owner":"garywiz","description":"Docker base images which use the chaperone lightweight process manager.","archived":false,"fork":false,"pushed_at":"2018-10-05T07:48:36.000Z","size":801,"stargazers_count":64,"open_issues_count":5,"forks_count":11,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-07-31T21:56:54.556Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/garywiz.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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-06-17T01:26:44.000Z","updated_at":"2023-07-01T13:44:56.000Z","dependencies_parsed_at":"2022-08-07T23:30:08.176Z","dependency_job_id":null,"html_url":"https://github.com/garywiz/chaperone-docker","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garywiz%2Fchaperone-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garywiz%2Fchaperone-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garywiz%2Fchaperone-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garywiz%2Fchaperone-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/garywiz","download_url":"https://codeload.github.com/garywiz/chaperone-docker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243667692,"owners_count":20328032,"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":[],"created_at":"2024-07-30T21:00:59.321Z","updated_at":"2026-01-12T03:03:47.834Z","avatar_url":"https://github.com/garywiz.png","language":"JavaScript","readme":"# Ubuntu and Alpine Docker images which use the Chaperone process manager\n\nThis repository is used to build several base-iamges which use the\n[Chaperone](http://garywiz.github.io/chaperone/guide/chap-intro.html) lightweight process manager.\n\nSeveral images are included based upon Ubuntu 14.04:\n\n * chaperone-baseimage (A framework for Chaperone-based development.  On\n   [Docker Hub as chaperone-baseimage](https://registry.hub.docker.com/u/chapdev/chaperone-baseimage).\n * chaperone-lamp (A LAMP image managed by Chaperone.  On\n   [Docker Hub as chaperone-lamp](https://registry.hub.docker.com/u/chapdev/chaperone-lamp).\n * chaperone-lemp (A LEMP image with Nginx instead of Apache, managed by Chaperone.  On\n   [Docker Hub as chaperone-lemp](https://registry.hub.docker.com/u/chapdev/chaperone-lemp).\n * chaperone-apache (An Apache-only image, managed by Chaperone.  On\n   [Docker Hub as chaperone-lemp](https://registry.hub.docker.com/u/chapdev/chaperone-apache).\n\nIn addition, these images are designed for leaner deployments, and are based upon Alpine Linux:\n\n * chaperone-alpinebase (A 55MB Alpine Linux image including Python3, managed by Chaperone.  On\n   [Docker Hub as chaperone-alpinebase](https://registry.hub.docker.com/u/chapdev/chaperone-alpinebase).\n * chaperone-alpinejava (A 210MB Alpine image containing Oracle Java 8 and Python3, managed by Chaperone. On\n   [Docker Hub as chaperone-alpinejava](https://registry.hub.docker.com/u/chapdev/chaperone-alpinejava).\n * alpine-nginx-php (A 75MB Alpine image containing Nginx, PHP, Python3, managed by Chaperone. On\n   [Docker Hub as alpine-nginx-php](https://registry.hub.docker.com/u/chapdev/alpine-nginx-php).\n * alpine-nginx-django (A 87MB Apine image containing Nginx, uWSGI, Python3, and Django 1.9, managed by Chaperone. On\n   [Docker Hub as alpine-nginx-django](https://registry.hub.docker.com/u/chapdev/alpine-nginx-django).\n   \nChaperone is a lightweight process manager specifically designed as an ENTRYPOINT for Docker containers that runs as PID 1.\nAs a single controlling process, it provides:\n\n  * Dependency based [parallel start-up of services](http://garywiz.github.io/chaperone/ref/config-service.html).\n  * [Built in syslog implementation](http://garywiz.github.io/chaperone/ref/config-logging.html), which listens on /dev/log and allows\n    flexible redirection of all log output to docker stdout, or simultaneously\n    to log files.\n  * Support for ``systemd`` NOTIFY process types with in-container emulation of notify sockets to\n\tbetter manage process life-cycles.\n  * PID cleanup, environment variable control, docker-friendly command line options, many many more features.\n\nChaperone's philosphy is to simplify management of multi-process containers and consolidate everything a container needs\nin a single, compact process.\n\nThe [Reference Documentation for Chaperone](http://garywiz.github.io/chaperone/ref/index.html) is complete, and\nmore examples and Docker usage information is on the way.\n\nChaperone is newly developed, so keep in mind that this is currently in Beta and we would not recommend these images\nfor production.  *Please* [submit issues](https://github.com/garywiz/chaperone-docker/issues) if you have any problems or suggestions!\n\n## Try it out\n\nAll of these images work the same way.  To get a quick idea of how things work, try the LAMP image and create your own \nuserspace development directory.  It's best if you do this *as a normal user* that is a member of the docker group, since \nthat will give you a good idea of how the userspace development model works.\n\nFirst, get the `chaplocal` script, a quick script which allows you to create userspace development \"home directories\":\n\n    docker run -i --rm chapdev/chaperone-lamp --task get-chaplocal | sh\n\nYou now have a script in your current directory called ``chaplocal``.\nUse it to create a new LAMP development directory:\n\n    ./chaplocal test-app\n\nOnce you do, you'll be put into the container in a bash shell.  You can inspect the running environment,\nand note how all files, including log files, databases, and development directories are part of your\nshared mount point, all running under your user ID.   When production images are required, a\n`build.sh` script inside the `test-app` directory will let you capture your development files\nand package them in an image which will run your application.\n\nYou can also see a quick overview of the services running by going to the sample site at http://localhost:8080\n(where localhost is whatever you've called your docker host machine).\n\nImages also support a `get-help` feature so you can find out about the version you have, for example\nyou can simply say:\n\n    docker run -i --rm chapdev/chaperone-alpinejava --task get-help\n       \nWe still have more work to do on these images, and feedback would be great.  This approach\nhas solved a lot of problems for us.\n\n## License\n\nCopyright (c) 2015, Gary J. Wisniewski \u003cgaryw@blueseastech.com\u003e\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n   http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n","funding_links":[],"categories":["Docker Images","JavaScript","Useful Images","others"],"sub_categories":["Dockerfile"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgarywiz%2Fchaperone-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgarywiz%2Fchaperone-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgarywiz%2Fchaperone-docker/lists"}