{"id":13508887,"url":"https://github.com/compose-spec/compose-spec","last_synced_at":"2025-05-13T23:10:38.282Z","repository":{"id":37336816,"uuid":"227151548","full_name":"compose-spec/compose-spec","owner":"compose-spec","description":"The Compose specification","archived":false,"fork":false,"pushed_at":"2024-10-26T00:02:27.000Z","size":781,"stargazers_count":2252,"open_issues_count":105,"forks_count":764,"subscribers_count":63,"default_branch":"main","last_synced_at":"2024-10-29T15:45:44.461Z","etag":null,"topics":["compose","containers","docker","kubernetes","specification"],"latest_commit_sha":null,"homepage":"https://compose-spec.io","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/compose-spec.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":"GOVERNANCE.md","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-12-10T15:16:39.000Z","updated_at":"2024-10-29T09:11:09.000Z","dependencies_parsed_at":"2023-10-16T20:07:26.432Z","dependency_job_id":"0deee4c9-a233-4ba7-bad9-ab0a889a4034","html_url":"https://github.com/compose-spec/compose-spec","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/compose-spec%2Fcompose-spec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/compose-spec%2Fcompose-spec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/compose-spec%2Fcompose-spec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/compose-spec%2Fcompose-spec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/compose-spec","download_url":"https://codeload.github.com/compose-spec/compose-spec/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248271925,"owners_count":21075800,"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":["compose","containers","docker","kubernetes","specification"],"created_at":"2024-08-01T02:01:00.007Z","updated_at":"2025-04-10T18:46:03.504Z","avatar_url":"https://github.com/compose-spec.png","language":"Dockerfile","readme":"# Compose Specification\n{:.no_toc}\n\nThe Compose specification establishes a standard for the definition of\nmulti-container platform-agnostic applications. The specification can be found\n[here](00-overview.md).\n\n* ToC\n{:toc}\n\n## Use cases\n\nTo provide more context on the Compose specification the following section gives\nexample use cases for each part of the specification.\n\n### Development tools\n\nDevelopers can use a Compose file to specify a container-based application\nthat will run as a set of containers on a local container engine. The Compose\nimplementation in this scenario could offer some specific features (local\nvolume binding, live-reload) to better address development needs. The\napplication definition and Compose model is the same used as that used for other\nuse cases. Platform features expected by the specification (like configs and\nsecrets) can be mocked with local resources.\n\n### Kubernetes deployment\n\nKubernetes container orchestration relies on a set of abstract concepts and\nAPIs to manage networking services, container deployments and their lifecycles.\nWhile this offers flexibility to address many operator use cases, it makes\nsimple use cases, like the developer use case, more complicated to express than\nthey need to be. Projects like [Kompose](https://github.com/kubernetes/kompose)\nor [Okteto Stacks](https://okteto.com/docs/reference/stacks) show how the\nsimpler Compose model can be translated into Kubernetes API payloads and make\nthe Compose file the source of truth for development and deployment.\n\n### Cloud providers\n\nSome cloud providers offer proprietary container hosting solutions based on\nin-house orchestrators and custom APIs. The Compose specification offers a\nsimple model that can be mapped to these hosting solutions so that users can\nreuse Compose files that they already have and so that they do not need to learn\ncustom configuration file formats. Platform specific features can be added\neither using Compose extensions or a dedicated configuration file along side the\nCompose file.\n\n## Contributing\n\nDevelopment happens on GitHub for the specification. Issues are used to track\nbugs and actionable items. Longer discussions can happen on the\n[mailing list](https://groups.google.com/forum/#!forum/compose-spec).\n\nThe specification and code is licensed under the Apache 2.0 license found in the\n[LICENSE](LICENSE) file.\n\n## Implementations\n\n[Docker Compose](https://github.com/docker/compose) is the Reference Implementation of the Compose Specification.\n\nCompose Specification is also implemented by:\n\n* [Kompose](https://github.com/kubernetes/kompose)\n* [Nerdctl](https://github.com/containerd/nerdctl)\n* [Okteto Stacks](https://okteto.com/docs/reference/stacks)\n* [Docker Cloud Integrations](https://github.com/docker/compose-cli)\n* [Podman Compose](https://github.com/containers/podman-compose)\n\n| Metadata |                  |\n| -------- | ---------------: |\n| Status   | Work in progress |\n| Created  | 2020-01-02       |\n","funding_links":[],"categories":["Dockerfile","kubernetes","Tools"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcompose-spec%2Fcompose-spec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcompose-spec%2Fcompose-spec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcompose-spec%2Fcompose-spec/lists"}