{"id":26088779,"url":"https://github.com/gardener/machine-controller-manager-provider-aws","last_synced_at":"2026-02-18T08:06:00.394Z","repository":{"id":37828293,"uuid":"168359874","full_name":"gardener/machine-controller-manager-provider-aws","owner":"gardener","description":"Gardener machine controller manager provider for AWS","archived":false,"fork":false,"pushed_at":"2025-02-12T07:01:28.000Z","size":21017,"stargazers_count":10,"open_issues_count":6,"forks_count":38,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-03-09T08:13:25.469Z","etag":null,"topics":["aws","machine-controller-manager"],"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/gardener.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-01-30T14:51:02.000Z","updated_at":"2025-02-12T07:01:32.000Z","dependencies_parsed_at":"2023-09-23T15:45:12.002Z","dependency_job_id":"d658e5fc-9c39-4367-b21e-3e38a3cae563","html_url":"https://github.com/gardener/machine-controller-manager-provider-aws","commit_stats":null,"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gardener%2Fmachine-controller-manager-provider-aws","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gardener%2Fmachine-controller-manager-provider-aws/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gardener%2Fmachine-controller-manager-provider-aws/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gardener%2Fmachine-controller-manager-provider-aws/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gardener","download_url":"https://codeload.github.com/gardener/machine-controller-manager-provider-aws/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244066179,"owners_count":20392406,"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":["aws","machine-controller-manager"],"created_at":"2025-03-09T08:13:31.647Z","updated_at":"2026-01-22T12:41:30.940Z","avatar_url":"https://github.com/gardener.png","language":"Go","readme":"# machine-controller-manager-provider-aws\n\n[![REUSE status](https://api.reuse.software/badge/github.com/gardener/machine-controller-manager-provider-aws)](https://api.reuse.software/info/github.com/gardener/machine-controller-manager-provider-aws)\n\nOut of tree (controller based) implementation for `AWS` as a new provider.\n\n## About\n- The AWS Out Of Tree provider implements the interface defined at [MCM OOT driver](https://github.com/gardener/machine-controller-manager/blob/master/pkg/util/provider/driver/driver.go).\n\n## Fundamental Design Principles:\nFollowing are the basic principles kept in mind while developing the external plugin.\n* Communication between this Machine Controller (MC) and Machine Controller Manager (MCM) is achieved using the Kubernetes native declarative approach.\n* Machine Controller (MC) behaves as the controller used to interact with the cloud provider AWS and manage the VMs corresponding to the machine objects.\n* Machine Controller Manager (MCM) deals with higher level objects such as machine-set and machine-deployment objects.\n\n## Support for a new provider\n- Steps to be followed while implementing/testing a new provider are mentioned [here](https://github.com/gardener/machine-controller-manager/blob/master/docs/development/cp_support_new.md)\n\n## Testing the AWS OOT\n\n1. Open terminal pointing to `$GOPATH/src/github.com/gardener`. Clone this repository. \n\n2. Navigate to `$GOPATH/src/github.com/gardener/machine-controller-manager-provider-aws`. \n    - In the `MAKEFILE` make sure `$TARGET_KUBECONFIG` points to the cluster where you wish to manage machines. `$CONTROL_NAMESPACE` represents the namespaces where MCM is looking for machine CR objects, and `$CONTROL_KUBECONFIG` points to the cluster which holds these machine CRs. \n    - Run the machine controller (driver) using the command below.\n        ```bash\n        make start\n        ```\n3. On the second terminal pointing to `$GOPATH/src/github.com/gardener`,\n    - Clone the [latest MCM code](https://github.com/gardener/machine-controller-manager)\n        ```bash\n        git clone git@github.com:gardener/machine-controller-manager.git\n        ```\n    - Navigate to the newly created directory.\n        ```bash\n        cd machine-controller-manager\n        ```\n    - Deploy the required CRDs from the machine-controller-manager repo,\n        ```bash\n        kubectl apply -f kubernetes/crds.yaml\n        ```\n    - Run the machine-controller-manager in the `cmi-client` branch\n        ```bash\n        make start\n        ```\n4. On the third terminal pointing to `$GOPATH/src/github.com/gardener/machine-controller-manager-provider-aws`\n    - Fill in the object files given below and deploy them as described below.\n    - Deploy the `machine-class`\n        ```bash\n        kubectl apply -f kubernetes/machine-class.yaml\n        ```\n    - Deploy the `kubernetes secret` if required.\n        ```bash\n        kubectl apply -f kubernetes/secret.yaml\n        ```\n    - Deploy the `machine` object and make sure it joins the cluster successfully.\n        ```bash\n        kubectl apply -f kubernetes/machine.yaml\n        ```\n    - Once machine joins, you can test by deploying a machine-deployment.\n    - Deploy the `machine-deployment` object and make sure it joins the cluster successfully.\n        ```bash\n        kubectl apply -f kubernetes/machine-deployment.yaml\n        ```\n    - Make sure to delete both the `machine` and `machine-deployment` object after use.\n        ```bash\n        kubectl delete -f kubernetes/machine.yaml\n        kubectl delete -f kubernetes/machine-deployment.yaml\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgardener%2Fmachine-controller-manager-provider-aws","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgardener%2Fmachine-controller-manager-provider-aws","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgardener%2Fmachine-controller-manager-provider-aws/lists"}