{"id":13439531,"url":"https://github.com/kubernetes/kompose","last_synced_at":"2026-01-18T03:58:39.802Z","repository":{"id":37432588,"uuid":"62088377","full_name":"kubernetes/kompose","owner":"kubernetes","description":"Convert Compose to Kubernetes","archived":false,"fork":false,"pushed_at":"2025-04-15T15:39:45.000Z","size":45035,"stargazers_count":9991,"open_issues_count":30,"forks_count":780,"subscribers_count":126,"default_branch":"main","last_synced_at":"2025-05-12T18:18:28.567Z","etag":null,"topics":["containers","docker","docker-compose","go","kubernetes"],"latest_commit_sha":null,"homepage":"http://kompose.io","language":"Go","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/kubernetes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"code-of-conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-06-27T21:08:18.000Z","updated_at":"2025-05-12T13:28:43.000Z","dependencies_parsed_at":"2023-09-26T04:56:52.659Z","dependency_job_id":"b6a35ec4-2c16-4de6-8a32-cc4bf1d8d84b","html_url":"https://github.com/kubernetes/kompose","commit_stats":{"total_commits":1150,"total_committers":143,"mean_commits":8.041958041958042,"dds":0.7782608695652173,"last_synced_commit":"5b563e7a8071b1b508ae538cfe94ec70f6ba1bdf"},"previous_names":["skippbox/kompose2","skippbox/kompose","kubernetes-incubator/kompose"],"tags_count":51,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes%2Fkompose","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes%2Fkompose/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes%2Fkompose/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes%2Fkompose/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kubernetes","download_url":"https://codeload.github.com/kubernetes/kompose/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253795162,"owners_count":21965488,"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":["containers","docker","docker-compose","go","kubernetes"],"created_at":"2024-07-31T03:01:14.772Z","updated_at":"2026-01-18T03:58:39.794Z","avatar_url":"https://github.com/kubernetes.png","language":"Go","readme":"# Kompose (Kubernetes + Compose)\n\n[![Build Status Widget]][Build Status] [![Coverage Status Widget]][Coverage Status] [![GoDoc Widget]][GoDoc]  [![GoReportCard Widget]][GoReportCardResult]\n\n![logo](/docs/assets/images/logo.png)\n\n`kompose` is a tool to help users who are familiar with `docker-compose` move to [Kubernetes](http://kubernetes.io). `kompose` takes a [Compose Specification](https://compose-spec.io/) file and translates it into Kubernetes resources.\n\n`kompose` is a convenience tool to go from local Compose environment to managing your application with Kubernetes. Transformation of the [Compose Specification](https://compose-spec.io/) format to Kubernetes resources manifest may not be exact, but it helps tremendously when first deploying an application on Kubernetes.\n\n## Use Case\n\nConvert [`compose.yaml`](https://raw.githubusercontent.com/kubernetes/kompose/main/examples/compose.yaml) into Kubernetes deployments and services with one simple command:\n\n```sh\n$ kompose convert -f compose.yaml\nINFO Kubernetes file \"frontend-service.yaml\" created\nINFO Kubernetes file \"redis-leader-service.yaml\" created\nINFO Kubernetes file \"redis-replica-service.yaml\" created\nINFO Kubernetes file \"frontend-deployment.yaml\" created\nINFO Kubernetes file \"redis-leader-deployment.yaml\" created\nINFO Kubernetes file \"redis-replica-deployment.yaml\" created\n```\n\nOther examples are provided in the _examples_ [directory](./examples).\n\n## Installation\n\nWe have multiple ways to install Kompose. Our preferred method is downloading the binary from the latest GitHub release.\n\nOur entire list of installation methods are located in our [installation.md](/docs/installation.md) document.\n\nInstallation methods:\n\n- [Binary (Preferred method)](/docs/installation.md#github-release)\n- [Go](/docs/installation.md#go)\n- [CentOS](/docs/installation.md#centos)\n- [openSUSE/SLE](/docs/installation.md#opensusesle)\n- [NixOS](/docs/installation.md#nixos)\n- [macOS (Homebrew and MacPorts)](/docs/installation.md#macos)\n- [Windows](/docs/installation.md#windows)\n- [Docker](/docs/installation.md#docker)\n\n#### Binary installation\n\nKompose is released via GitHub on a three-week cycle, you can see all current releases on the [GitHub release page](https://github.com/kubernetes/kompose/releases).\n\n**Linux and macOS:**\n\n```sh\n# Linux\ncurl -L https://github.com/kubernetes/kompose/releases/download/v1.38.0/kompose-linux-amd64 -o kompose\n\n# macOS\ncurl -L https://github.com/kubernetes/kompose/releases/download/v1.38.0/kompose-darwin-amd64 -o kompose\n\nchmod +x kompose\nsudo mv ./kompose /usr/local/bin/kompose\n```\n\n**Windows:**\n\nDownload from [GitHub](https://github.com/kubernetes/kompose/releases/download/v1.38.0/kompose-windows-amd64.exe) and add the binary to your PATH.\n\n## Shell autocompletion\n\nWe support Bash, Zsh and Fish autocompletion.\n\n```sh\n# Bash (add to .bashrc for persistence)\nsource \u003c(kompose completion bash)\n\n# Zsh (add to .zshrc for persistence)\nsource \u003c(kompose completion zsh)\n\n# Fish autocompletion\nkompose completion fish | source\n```\n\n## Development and building of Kompose\n\n### Building with `go`\n\n**Requisites:**\n\n1. [make](https://www.gnu.org/software/make/)\n2. [Golang](https://golang.org/) v1.6 or later\n3. Set `GOPATH` correctly or click [SettingGOPATH](https://github.com/golang/go/wiki/SettingGOPATH) for details\n\n**Steps:**\n\n1. Clone repository\n\n```console\n$ git clone https://github.com/kubernetes/kompose.git $GOPATH/src/github.com/kubernetes/kompose\n```\n\n2. Change directory to the cloned repo.\n\n```console\ncd $GOPATH/src/github.com/kubernetes/kompose\n```\n\n3. Build with `make`\n\n```console\n$ make bin\n```\n\n4. Or build with `go`\n\n```console\n$ go build -o kompose main.go\n```\n\n5. Test your changes\n\n```console\n$ make test\n```\n\n## Documentation\n\nDocumentation can be found at our [kompose.io](http://kompose.io) website or our [docs](https://github.com/kubernetes/kompose/tree/main/docs) folder.\n\nHere is a list of all available docs:\n\n- [Quick start](docs/getting-started.md)\n- [Installation](docs/installation.md)\n- [User guide](docs/user-guide.md)\n- [Conversion](docs/conversion.md)\n- [Architecture](docs/architecture.md)\n- [Development](docs/development.md)\n\n## Community, Discussion, Contribution, and Support\n\n**Issues:** If you find any issues, please [file it](https://github.com/kubernetes/kompose/issues).\n\n**Kubernetes Community:** As part of the Kubernetes ecosystem, we follow the Kubernetes community principles. More information can be found on the [community page](http://kubernetes.io/community/).\n\n**Chat (Slack):** We're fairly active on [Slack](http://slack.kubernetes.io#kompose) and you can find us in the #kompose channel.\n\n### Code of Conduct\n\nParticipation in the Kubernetes community is governed by the [Kubernetes Code of Conduct](code-of-conduct.md).\n\n[Build Status]: https://github.com/kubernetes/kompose/actions?query=workflow%3A%22Kompose+CI%22\n[Build Status Widget]: https://github.com/kubernetes/kompose/workflows/Kompose%20CI/badge.svg\n[GoDoc]: https://godoc.org/github.com/kubernetes/kompose\n[GoDoc Widget]: https://godoc.org/github.com/kubernetes/kompose?status.svg\n[Coverage Status Widget]: https://coveralls.io/repos/github/kubernetes/kompose/badge.svg?branch=main\n[Coverage Status]: https://coveralls.io/github/kubernetes/kompose?branch=main\n[GoReportCard Widget]: https://goreportcard.com/badge/github.com/kubernetes/kompose\n[GoReportCardResult]: https://goreportcard.com/report/github.com/kubernetes/kompose\n","funding_links":[],"categories":["HarmonyOS","Container Operations","Go","Configuration","Docker compose","Go (134)","Microservice","Configuration Management","go","Continuous Delivery \u0026 GitOps","kubernetes","Repositories","K8S-Tools","☁️ Cloud Platforms \u0026 Infrastructure","DevOps"],"sub_categories":["Windows Manager","Container Composition","[Jenkins](#jenkins)","Advanced","Tools"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubernetes%2Fkompose","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkubernetes%2Fkompose","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubernetes%2Fkompose/lists"}