{"id":13558565,"url":"https://github.com/cloudfoundry-incubator/kubecf","last_synced_at":"2025-04-03T13:31:37.168Z","repository":{"id":49157692,"uuid":"215725170","full_name":"cloudfoundry-incubator/kubecf","owner":"cloudfoundry-incubator","description":"Cloud Foundry on Kubernetes","archived":true,"fork":false,"pushed_at":"2021-06-25T20:44:47.000Z","size":4089,"stargazers_count":115,"open_issues_count":205,"forks_count":62,"subscribers_count":29,"default_branch":"master","last_synced_at":"2024-11-04T09:37:26.285Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/cloudfoundry-incubator.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":null,"support":null}},"created_at":"2019-10-17T07:02:54.000Z","updated_at":"2024-08-13T03:43:05.000Z","dependencies_parsed_at":"2022-08-25T20:21:02.961Z","dependency_job_id":null,"html_url":"https://github.com/cloudfoundry-incubator/kubecf","commit_stats":null,"previous_names":["suse/kubecf"],"tags_count":38,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-incubator%2Fkubecf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-incubator%2Fkubecf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-incubator%2Fkubecf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-incubator%2Fkubecf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudfoundry-incubator","download_url":"https://codeload.github.com/cloudfoundry-incubator/kubecf/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247009633,"owners_count":20868583,"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-08-01T12:05:01.837Z","updated_at":"2025-04-03T13:31:36.223Z","avatar_url":"https://github.com/cloudfoundry-incubator.png","language":"Shell","funding_links":[],"categories":["Shell","others","Deployment"],"sub_categories":[],"readme":"# KubeCF\n\n| Build step | State |\n| ---     | ---   |\n| Linting | [![lint](https://concourse.suse.dev/api/v1/teams/main/pipelines/kubecf/jobs/lint-master/badge)](https://concourse.suse.dev/teams/main/pipelines/kubecf/jobs/lint-master/) |\n| Building | [![build](https://concourse.suse.dev/api/v1/teams/main/pipelines/kubecf/jobs/build-master/badge)](https://concourse.suse.dev/teams/main/pipelines/kubecf/jobs/build-master/) |\n| Smoke tests on Diego | [![smoke-diego](https://concourse.suse.dev/api/v1/teams/main/pipelines/kubecf/jobs/smoke-tests-diego-master/badge)](https://concourse.suse.dev/teams/main/pipelines/kubecf/jobs/smoke-tests-diego-master/) |\n| Smoke tests on Eirini | [![smoke-eirini](https://concourse.suse.dev/api/v1/teams/main/pipelines/kubecf/jobs/smoke-tests-eirini-master/badge)](https://concourse.suse.dev/teams/main/pipelines/kubecf/jobs/smoke-tests-eirini-master/) |\n| Acceptance Tests on Diego | [![acceptance-diego](https://concourse.suse.dev/api/v1/teams/main/pipelines/kubecf/jobs/cf-acceptance-tests-diego-master/badge)](https://concourse.suse.dev/teams/main/pipelines/kubecf/jobs/cf-acceptance-tests-diego-master/) |\n| Acceptance Tests on Eirini | [![acceptance-diego](https://concourse.suse.dev/api/v1/teams/main/pipelines/kubecf/jobs/cf-acceptance-tests-eirini-master/badge)](https://concourse.suse.dev/teams/main/pipelines/kubecf/jobs/cf-acceptance-tests-eirini-master/) |\n\n## Introduction\n\nKubeCF is a distribution of Cloud Foundry Application Runtime (CFAR) for Kubernetes. \nIt works with the [cf-operator] from [Project Quarks] to deploy and manage releases built from [cf-deployment].\n\n[cf-operator]:   https://github.com/cloudfoundry-incubator/cf-operator/\n[Project Quarks]:           https://www.cloudfoundry.org/project-quarks/\n[cf-deployment]: https://github.com/cloudfoundry/cf-deployment/\n[Docs]:                     https://kubecf.io/\n\n## Documentation\n\nThe Community documentation website is [available here](https://kubecf.io/).\n\n## Contributing to KubeCF development\n\nSee the [Guide to Contribution](doc/Contribute.md).\n\n# System requirements\n\nTo work with `kubecf`, a variety of supporting tools are required.\nThese are:\n\n| Tool          | Notes                                                  |\n|---            |---                                                     |\n|k8s            | The platform to run KubeCF.                            |\n|minikube       | Provider for local k8s clusters.                       |\n|kind           | Provider for local k8s clusters.                       |\n|kubectl        | Client to talk to k8s clusters.                        |\n|Helm           | Handling helm charts.                                  |\n|[cf-operator]  | Processes BOSH deployments. Maps them to kube objects. |\n|[cf-deployment]| The CF release at the core of `kubecf`.                |\n\nAs most of the developers use the `Make \u0026 Bash` build system coming with the\n`kubecf` repository, they implicitly use the versions for the tools\nset down in __scripts/tools/*__. At the time of writing, these are:\n\nAt the time of this writing these were:\n\n| Tool          |             Version | Notes |\n|---------------|---------------------|-------|\n| Kubernetes    |              1.17.5 |       |\n| minikube      |               1.9.2 |       |\n| kind          |               0.6.0 |       |\n| kubectl       |              1.17.0 |       |\n| Helm          |               3.0.3 |       |\n| jq            |                 1.6 |       |\n| python3       |                 3.3 |       |\n| ruby          |                 2.4 |       |\n| shellcheck    |               0.7.0 |       |\n| yamllint      |                1.23 |       |\n| CF Operator   |  6.1.17+0.gec409fd7 |       |\n| cf-deployment |             13.17.0 |       |\n\n__Note however__: As `kubecf` is updated these versions may change\nfrom commit to commit.  The table above is therefore\n__not authoritative__.\n\n__Always__ check the contents of __dependencies.yaml__ and\n__scripts/tools/*__ for the authoritative answer.\n\n__Note further__: Just because the build system provides targets to\nconveniently bring up a local k8s cluster using minikube or kind, this\ndoes not preclude the use of other k8s cluster providers, local or in\nthe cloud.\n\nBesides the required tools noted above, other tools used by developers\nare:\n\n| Tool  | Notes                         | Location                         |\n|---    |---                            |---                               |\n|k9s    | Curses-based UI over kubectl  | https://github.com/derailed/k9s  |\n|stern  | Multi-pod log tailing         | https://github.com/wercker/stern |\n\nLast, but not least, __more documentation__ on how to work with\n`kubecf` is found in the [Guide to Contribution](doc/Contribute.md).\n\n## Useful Information\n\n| What                                   | Where                                                        |\n| -------------------------------------- | ------------------------------------------------------------ |\n| Concourse Pipeline                     | https://concourse.suse.dev/teams/main/pipelines/kubecf       |\n| S3 Bucket with helm charts\u003csup\u003e*\u003c/sup\u003e | https://kubecf.s3.amazonaws.com/index.html                   |\n| Cloud Foundry Operator                 | https://github.com/cloudfoundry-incubator/cf-operator/       |\n| CF Operator Charts                     | https://cf-operators.s3.amazonaws.com/helm-charts/index.html |\n\n\u003csub\u003e* The bundle file includes the operator chart\u003c/sub\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudfoundry-incubator%2Fkubecf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudfoundry-incubator%2Fkubecf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudfoundry-incubator%2Fkubecf/lists"}