ec2-controller

README

ACK service controller for Amazon Elastic Compute Cloud (EC2)

This repository contains source code for the AWS Controllers for Kubernetes (ACK) service controller for Amazon EC2.

Please log issues and feedback on the main AWS Controllers for Kubernetes Github project.

Install the Controller

Start with the Install an ACK Controller section to install the controller into a cluster and setup necessary IAM Permissions.

Note: it is recommended and assumed your local terminal has kubectl and AWS credentials configured to use the hosting cluster and AWS account, respectively.

Release Artifacts

The latest images and Helm Charts can be found in their respective ECR Public repository:

• Images
• Helm charts

Create/Delete an ACK Resource

• Navigate to test resources for a list of resource yaml templates
• Copy the file to the local terminal and substitute $ values. Ex: vpc.yaml

apiVersion: ec2.services.k8s.aws/v1alpha1
kind: VPC
metadata:
  name: $VPC_NAME
spec:
  cidrBlocks: 
  - $CIDR_BLOCK
  enableDNSSupport: $ENABLE_DNS_SUPPORT
  enableDNSHostnames: $ENABLE_DNS_HOSTNAMES
  tags:
    - key: $TAG_KEY
      value: $TAG_VALUE

• Create a VPC: kubectl apply -f vpc.yaml
• Check its status: kubectl describe vpc/My-ACK-Resource
• Delete the VPC: kubectl delete -f vpc.yaml

Uninstall the Controller

Navigate to Uninstall an ACK Controller section and substitute service values with ec2

Contributing

We welcome community contributions and pull requests.

See our contribution guide for more information on how to report issues, set up a development environment, and submit code.

We adhere to the Amazon Open Source Code of Conduct.

You can also learn more about our Governance structure.

License

This project is licensed under the Apache-2.0 License.