{"id":13465586,"url":"https://github.com/kubernetes-retired/federation","last_synced_at":"2025-12-12T00:34:45.063Z","repository":{"id":38375230,"uuid":"104268721","full_name":"kubernetes-retired/federation","owner":"kubernetes-retired","description":"[EOL] Cluster Federation","archived":true,"fork":false,"pushed_at":"2019-01-17T06:42:19.000Z","size":54667,"stargazers_count":210,"open_issues_count":0,"forks_count":82,"subscribers_count":24,"default_branch":"master","last_synced_at":"2024-10-19T16:26:40.034Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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-retired.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":"2017-09-20T21:18:48.000Z","updated_at":"2024-09-14T09:55:32.000Z","dependencies_parsed_at":"2022-09-19T09:11:04.672Z","dependency_job_id":null,"html_url":"https://github.com/kubernetes-retired/federation","commit_stats":null,"previous_names":["kubernetes/federation"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-retired%2Ffederation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-retired%2Ffederation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-retired%2Ffederation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-retired%2Ffederation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kubernetes-retired","download_url":"https://codeload.github.com/kubernetes-retired/federation/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222088587,"owners_count":16928983,"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-31T15:00:32.214Z","updated_at":"2025-12-12T00:34:45.018Z","avatar_url":"https://github.com/kubernetes-retired.png","language":"Go","funding_links":[],"categories":["Uncategorized","Cluster","Go"],"sub_categories":["Uncategorized"],"readme":"# Cluster Federation\n\nKubernetes Cluster Federation enables users to federate multiple\nKubernetes clusters.\nTo know more details about the same please see the\n[user guide](https://kubernetes.io/docs/concepts/cluster-administration/federation/).\n\n## Deploying Kubernetes Cluster Federation\n\nThe prescribed mechanism to deploy Kubernetes Cluster Federation is using\n[kubefed](https://kubernetes.io/docs/admin/kubefed/).\nA complete guide for the same is available at\n[setup cluster federation using kubefed](https://kubernetes.io/docs/tutorials/federation/set-up-cluster-federation-kubefed/).\n\n## Building Kubernetes Cluster Federation\n\nBuilding cluster federation binaries, which include fcp (short for federation\ncontrol plane) and [kubefed](https://kubernetes.io/docs/admin/kubefed/) \nshould be as simple as running:\n```shell\nmake\n```\n\nA kubernetes like release packages can also be built using:\n```shell\nmake quick-release\n```\n\nThe '`kubefed` binary can be found in `federation-client-*.tar.gz`.\nThe `fcp` binary, which self contains `federation-apiserver` and\n`federation-controller-manager` can be found in `federation-server-*.tar.gz`.\n`federation-server-*.tar.gz` includes `fcp-*.tar`, which is the fcp docker \nimage in the tar format and can be consumed by the `kubefed` tool.\n\nTo run the docker image load the container on your build machine and push to your repository:\n```shell\n# Run from $GOPATH/src/k8s.io/kubernetes/federation\ndocker load -i  _output/release-images/amd64/fcp-amd64.tar\n\n# Tag to your REGISTRY/REPO/IMAGENAME[:TAG]\ndocker docker tag gcr.io/google_containers/fcp-amd64:v1.9.0-alpha.2.60_430416309f9e58-dirty REGISTRY/REPO/IMAGENAME[:TAG] \n\n# push to your registry\ndocker push REGISTRY/REPO/IMAGENAME[:TAG]\n```\n\nthen bring up the new control plane:\n```shell\n_output/dockerized/bin/linux/amd64/kubefed init myfed --host-cluster-context=HOST_CLUSTER_CONTEXT --image=REGISTRY/REPO/IMAGENAME[:TAG] --dns-provider=\"PROVIDER\" --dns-zone-name=\"YOUR_ZONE\" --dns-provider-config=/path/to/provider.conf\n```\n\n## A note to the reader\nKubernetes federation code is in a state of flux. Since its incubation, it \nlived in [core kubernetes repo](https://github.com/kubernetes/kubernetes).\nThe same now is maturing into [its own placeholder](https://github.com/kubernetes/federation).\nThe process of this movement is not yet complete. It already borrows a lot \nof code from its earlier parent, especially build infrastructure and utility \nscripts. This will be cleaned up and simplified. Subsequently we will also \nconcentrate our efforts into cleaning issues and problems reported on existing \nfeatures, with a focus of moving atleast a subset of all federation features \ntowards GA.\nPlease raise an issue, in case you find problems and we welcome developers \nto participate in this effort.\n\n## Community, discussion, contribution, and support\n\nLearn how to engage with the Kubernetes community on the [community page](http://kubernetes.io/community/).\n\nYou can reach the maintainers of this project at:\n\n- [Slack channel](https://kubernetes.slack.com/messages/sig-multicluster)\n- [Mailing list](https://groups.google.com/forum/#!forum/kubernetes-sig-multicluster)\n\n### Code of conduct\n\nParticipation in the Kubernetes community is governed by the [Kubernetes Code of Conduct](code-of-conduct.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubernetes-retired%2Ffederation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkubernetes-retired%2Ffederation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubernetes-retired%2Ffederation/lists"}