{"id":30047600,"url":"https://github.com/tmax-cloud/install-kubevirt","last_synced_at":"2025-08-07T09:56:51.541Z","repository":{"id":46685254,"uuid":"277423073","full_name":"tmax-cloud/install-kubevirt","owner":"tmax-cloud","description":null,"archived":false,"fork":false,"pushed_at":"2021-09-30T05:15:10.000Z","size":11142,"stargazers_count":0,"open_issues_count":0,"forks_count":3,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-19T10:10:08.729Z","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tmax-cloud.png","metadata":{"files":{"readme":"README-failover-controller.md","changelog":"CHANGELOG-failover-controller.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-07-06T02:23:20.000Z","updated_at":"2021-02-08T11:34:46.000Z","dependencies_parsed_at":"2022-09-03T20:01:52.857Z","dependency_job_id":null,"html_url":"https://github.com/tmax-cloud/install-kubevirt","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tmax-cloud/install-kubevirt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmax-cloud%2Finstall-kubevirt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmax-cloud%2Finstall-kubevirt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmax-cloud%2Finstall-kubevirt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmax-cloud%2Finstall-kubevirt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tmax-cloud","download_url":"https://codeload.github.com/tmax-cloud/install-kubevirt/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmax-cloud%2Finstall-kubevirt/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269236777,"owners_count":24383241,"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","status":"online","status_checked_at":"2025-08-07T02:00:09.698Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":"2025-08-07T09:56:37.481Z","updated_at":"2025-08-07T09:56:51.516Z","avatar_url":"https://github.com/tmax-cloud.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Failover Controller 설치 가이드\n\nTmax A\u0026C, CK2-1 Team\n\u003e Taesun Lee \u003ctaesun_lee@tmax.co.kr\u003e, Haemyung Yang \u003chaemyung_yang@tmax.co.kr\u003e\n\n## 구성 요소 및 버전\n\n* failover-controller docker image\n  * 버전: v1.5\n  * `최신 버전 정보`는 [tmaxcloudck/kube-failover-controller docker hub](https://hub.docker.com/r/tmaxcloudck/kube-failover-controller/tags) 또는 [CHANGELOG-failover-controller.md](CHANGELOG-failover-controller.md) 파일에서 확인 가능합니다.\n* `apps/v1` 를 사용함으로 Kubernetes 버전 `v1.9` 이상을 사용해야합니다..\n\n## 폐쇄망 구축 가이드\n\n1. 폐쇄망에서 설치하는 경우\n\n  *  작업 디렉토리 생성 및 환경 설정\n  ```sh\n  $ mkdir -p ~/failover-controller\n  $ export FAILOVER_VERSION=${failover controller image version}\n  $ export DOCKER_REGISTRY=${docker_registry}\n  $ export FAILOVER_HOME=~/failover-controller\n  $ export VERSION_NAME=main # main 혹은 4.1 등 설치를 위한 version(git branch 명)을 사용\n  $ cd $FAILOVER_HOME\n  ```\n\n  * 외부 통신이 가능한 환경에서 필요한 이미지 및 yaml 파일을 다운받고 해당 파일을 Master의 $FAILOVER_HOME으로 이동시킨다.\n  ```sh\n  $ docker pull tmaxcloudck/kube-failover-controller:$FAILOVER_VERSION\n  $ docker save tmaxcloudck/kube-failover-controller:$FAILOVER_VERSION \u003e failover-controller.tar\n  $ wget https://raw.githubusercontent.com/tmax-cloud/install-kubevirt/${VERSION_NAME}/manifest/yamls/failover-controller.yaml\n  ```\n\n  * failover-controller.tar를 docker-registry에 배포 한다.\n  ```sh\n  $ docker load -i failover-controller.tar \n  $ docker tag tmaxcloudck/kube-failover-controller:${FAILOVER_VERSION} ${DOCKER_REGISTRY}/tmaxcloudck/kube-failover-controller:${FAILOVER_VERSION}\n  $ docker push ${DOCKER_REGISTRY}/tmaxcloudck/kube-failover-controller:${FAILOVER_VERSION}\n  $ sed -i \"s/tmaxcloudck\\/kube-failover-controller:%FAILOVER_VERSION%/${DOCKER_REGISTRY}\\/tmaxcloudck\\/kube-failover-controller:${FAILOVER_VERSION}/g\" ${FAILOVER_HOME}/manifest/yamls/failover-controller.yaml\n  $ sed -i \"s@%HOME%@${HOME}@g\" ${FAILOVER_HOME}/manifest/yamls/failover-controller.yaml\n  ```\n  \n## 설치 가이드\n\n### Step 1. Controller 배포:\n\n* k8s cluster 환경에서 failover controller를 배포한다. \n\n```sh\n$ kubectl apply -f failover-controller.yaml\n```\n\n### Step 2. Controller 확인:\n\n* k8s cluster의 master node에 controller가 정상적으로 배포되었는지 확인한다.(status Running 확인)\n\n```sh\n$ kubectl get pods -n kubevirt-system\n```\n![image](manifest/figure/kubevirt-failover-controller.PNG)\n\n\n## 삭제 가이드\n\n* 다음의 명령을 실행하여 failover controller를 삭제한다.\n\n```sh\nkubectl delete -f manifests/failover-controller.yaml\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftmax-cloud%2Finstall-kubevirt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftmax-cloud%2Finstall-kubevirt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftmax-cloud%2Finstall-kubevirt/lists"}