README
¶
provider-aws
Overview
This provider-aws repository is the Crossplane infrastructure provider for
Amazon Web Services (AWS). The provider that is built
from the source code in this repository can be installed into a Crossplane
control plane and adds the following new functionality:
- Custom Resource Definitions (CRDs) that model AWS infrastructure and services (e.g. Amazon Relational Database Service (RDS), EKS clusters, etc.)
- Controllers to provision these resources in AWS based on the users desired state captured in CRDs they create
- Implementations of Crossplane's portable resource abstractions, enabling AWS resources to fulfill a user's general need for cloud services
Getting Started and Documentation
For getting started guides, installation, deployment, and administration, see our Documentation.
Contributing
provider-aws is a community driven project and we welcome contributions. See the Crossplane Contributing guidelines to get started.
Adding New Resource
We use AWS Go code generation pipeline to generate new controllers. See Code Generation Guide to add a new resource.
Releases
AWS Provider is released every 4 weeks and we issue patch releases as necessary.
For example, v0.20.0 is released on October 19, 2021. The next minor
release v0.21.0 will be cut on November 16, 2021, and so on.
Report a Bug
For filing bugs, suggesting improvements, or requesting new features, please open an issue.
Contact
Please use the following to reach members of the community:
- Slack: Join our slack channel
- Forums: crossplane-dev
- Twitter: @crossplane_io
- Email: info@crossplane.io
Roadmap
provider-aws goals and milestones are currently tracked in the Crossplane repository. More information can be found in ROADMAP.md.
Governance and Owners
provider-aws is run according to the same Governance and Ownership structure as the core Crossplane project.
Code of Conduct
provider-aws adheres to the same Code of Conduct as the core Crossplane project.
Licensing
provider-aws is under the Apache 2.0 license.
Directories
¶
| Path | Synopsis |
|---|---|
|
Package apis contains Kubernetes API groups for AWS cloud provider.
|
Package apis contains Kubernetes API groups for AWS cloud provider. |
|
acm
Package acm contains certificate manager API versions
|
Package acm contains certificate manager API versions |
|
acm/v1alpha1
Package v1alpha1 contains API Schema definitions for the acm v1alpha1 API group +kubebuilder:object:generate=true +groupName=acm.aws.crossplane.io +versionName=v1alpha1
|
Package v1alpha1 contains API Schema definitions for the acm v1alpha1 API group +kubebuilder:object:generate=true +groupName=acm.aws.crossplane.io +versionName=v1alpha1 |
|
acm/v1beta1
Package v1beta1 contains API Schema definitions for the acm v1alpha1 API group +kubebuilder:object:generate=true +groupName=acm.aws.crossplane.io +versionName=v1beta1
|
Package v1beta1 contains API Schema definitions for the acm v1alpha1 API group +kubebuilder:object:generate=true +groupName=acm.aws.crossplane.io +versionName=v1beta1 |
|
acmpca
Package acmpca contains Private Certificate Authority API versions
|
Package acmpca contains Private Certificate Authority API versions |
|
acmpca/v1alpha1
Package v1alpha1 contains API Schema definitions for the acmpca v1alpha1 API group +kubebuilder:object:generate=true +groupName=acmpca.aws.crossplane.io +versionName=v1alpha1
|
Package v1alpha1 contains API Schema definitions for the acmpca v1alpha1 API group +kubebuilder:object:generate=true +groupName=acmpca.aws.crossplane.io +versionName=v1alpha1 |
|
acmpca/v1beta1
Package v1beta1 contains API Schema definitions for the acmpca v1alpha1 API group +kubebuilder:object:generate=true +groupName=acmpca.aws.crossplane.io +versionName=v1beta1
|
Package v1beta1 contains API Schema definitions for the acmpca v1alpha1 API group +kubebuilder:object:generate=true +groupName=acmpca.aws.crossplane.io +versionName=v1beta1 |
|
batch/manualv1alpha1
Package manualv1alpha1 is the v1alpha1 version of the batch.aws.crossplane.io API.
|
Package manualv1alpha1 is the v1alpha1 version of the batch.aws.crossplane.io API. |
|
cache
Package cache contains AWS cache API versions
|
Package cache contains AWS cache API versions |
|
cache/v1alpha1
Package v1alpha1 contains managed resources for AWS caching services such as ElastiCache.
|
Package v1alpha1 contains managed resources for AWS caching services such as ElastiCache. |
|
cache/v1beta1
Package v1beta1 contains managed resources for AWS caching services such as ElastiCache.
|
Package v1beta1 contains managed resources for AWS caching services such as ElastiCache. |
|
cognitoidentityprovider/manualv1alpha1
Package manualv1alpha1 contains managed resources for the Amazon Cognito service such as GroupUserMembership.
|
Package manualv1alpha1 contains managed resources for the Amazon Cognito service such as GroupUserMembership. |
|
common
Package common contains shared types that are used in multiple CRDs.
|
Package common contains shared types that are used in multiple CRDs. |
|
database
Package database contains AWS database API versions
|
Package database contains AWS database API versions |
|
database/v1beta1
Package v1beta1 contains managed resources for AWS database services such as RDS.
|
Package v1beta1 contains managed resources for AWS database services such as RDS. |
|
ec2/v1beta1
Package v1beta1 contains managed resources for AWS network services such as VPC and Subnet.
|
Package v1beta1 contains managed resources for AWS network services such as VPC and Subnet. |
|
ecr/v1alpha1
Package v1alpha1 contains managed resources for AWS ECR services +kubebuilder:object:generate=true +groupName=ecr.aws.crossplane.io +versionName=v1alpha1
|
Package v1alpha1 contains managed resources for AWS ECR services +kubebuilder:object:generate=true +groupName=ecr.aws.crossplane.io +versionName=v1alpha1 |
|
ecr/v1beta1
Package v1beta1 contains managed resources for AWS ECR services +kubebuilder:object:generate=true +groupName=ecr.aws.crossplane.io +versionName=v1beta1
|
Package v1beta1 contains managed resources for AWS ECR services +kubebuilder:object:generate=true +groupName=ecr.aws.crossplane.io +versionName=v1beta1 |
|
eks
Package eks contains AWS EKS API versions
|
Package eks contains AWS EKS API versions |
|
eks/manualv1alpha1
Package manualv1alpha1 contains managed resources for AWS Elastic Kubernetes Service such as NodeGroup.
|
Package manualv1alpha1 contains managed resources for AWS Elastic Kubernetes Service such as NodeGroup. |
|
eks/v1beta1
Package v1beta1 contains managed resources for AWS Elastic Kubernetes Service such as Cluster.
|
Package v1beta1 contains managed resources for AWS Elastic Kubernetes Service such as Cluster. |
|
elasticloadbalancing/v1alpha1
Package v1alpha1 contains managed resources for AWS Elastic Load Balancing services such as IAM.
|
Package v1alpha1 contains managed resources for AWS Elastic Load Balancing services such as IAM. |
|
elbv2/manualv1alpha1
Package manualv1alpha1 contains manually creaed managed resources for AWS Elastic Loadbalancing V2.
|
Package manualv1alpha1 contains manually creaed managed resources for AWS Elastic Loadbalancing V2. |
|
iam/v1beta1
Package v1beta1 contains managed resources for AWS identity services such as IAM.
|
Package v1beta1 contains managed resources for AWS identity services such as IAM. |
|
lambda/manualv1alpha1
Package manualv1alpha1 is the v1alpha1 version of the lambda.aws.crossplane.io API.
|
Package manualv1alpha1 is the v1alpha1 version of the lambda.aws.crossplane.io API. |
|
redshift/v1alpha1
Package v1alpha1 contains managed resources for AWS Redshift services such as Cluster.
|
Package v1alpha1 contains managed resources for AWS Redshift services such as Cluster. |
|
route53/v1alpha1
Package v1alpha1 contains managed resources for AWS network services such as HostedZone and ResourceRecordSet.
|
Package v1alpha1 contains managed resources for AWS network services such as HostedZone and ResourceRecordSet. |
|
route53resolver/manualv1alpha1
Package manualv1alpha1 contains managed resources for AWS network services such as Route Resolver Rule Association +kubebuilder:object:generate=true +groupName=route53resolver.aws.crossplane.io +versionName=v1alpha1
|
Package manualv1alpha1 contains managed resources for AWS network services such as Route Resolver Rule Association +kubebuilder:object:generate=true +groupName=route53resolver.aws.crossplane.io +versionName=v1alpha1 |
|
s3
Package s3 contains AWS S3 API versions
|
Package s3 contains AWS S3 API versions |
|
s3/common
Package common contains shared types that are used in multiple S3 CRDs.
|
Package common contains shared types that are used in multiple S3 CRDs. |
|
s3/v1alpha3
Package v1alpha3 contains configuration resources for AWS S3 services such as S3.
|
Package v1alpha3 contains configuration resources for AWS S3 services such as S3. |
|
s3/v1beta1
Package v1beta1 contains managed resources for AWS S3.
|
Package v1beta1 contains managed resources for AWS S3. |
|
secretsmanager
Package secretsmanager contains AWS Secrets Manager API versions
|
Package secretsmanager contains AWS Secrets Manager API versions |
|
sns
Package sns contains AWS SNS API versions
|
Package sns contains AWS SNS API versions |
|
sns/v1beta1
Package v1beta1 contains managed resources for AWS SNS services such as Topic & Subscription.
|
Package v1beta1 contains managed resources for AWS SNS services such as Topic & Subscription. |
|
sqs/v1beta1
Package v1beta1 contains managed resources for AWS SQS resources such as Queues.
|
Package v1beta1 contains managed resources for AWS SQS resources such as Queues. |
|
v1alpha1
Package v1alpha1 contains core AWS resources.
|
Package v1alpha1 contains core AWS resources. |
|
v1beta1
Package v1beta1 contains core AWS resources.
|
Package v1beta1 contains core AWS resources. |
|
cmd
|
|
|
pkg
|
|
|
clients/mock/cognitoidentityprovider
Package cognitoidentityprovider is a generated GoMock package.
|
Package cognitoidentityprovider is a generated GoMock package. |
|
clients/mock/ec2iface
Package ec2iface is a generated GoMock package.
|
Package ec2iface is a generated GoMock package. |
|
clients/mock/eksiface
Package eksiface is a generated GoMock package.
|
Package eksiface is a generated GoMock package. |
|
clients/mock/kmsiface
Package kmsiface is a generated GoMock package.
|
Package kmsiface is a generated GoMock package. |
|
clients/mock/kube
Package kube is a generated GoMock package.
|
Package kube is a generated GoMock package. |
|
clients/mock/transferiface
Package transferiface is a generated GoMock package.
|
Package transferiface is a generated GoMock package. |
|
utils/policy/old
Deprecated use the policy package that contains better parser support.
|
Deprecated use the policy package that contains better parser support. |
|
utils/reconciler/managed
Package managed provides a custom implementation of RetryingCriticalAnnotationUpdater from the crossplane-runtime package managed (github.com/crossplane/crossplane-runtime/pkg/reconciler/managed/api.go) This custom implementation is currently used in all controllers to revert back to the behavior before this breaking change from crossplane-runtime:v1.14.0 (https://github.com/crossplane/crossplane-runtime/pull/526) See also https://github.com/crossplane-contrib/provider-aws/pull/1953 for more information
|
Package managed provides a custom implementation of RetryingCriticalAnnotationUpdater from the crossplane-runtime package managed (github.com/crossplane/crossplane-runtime/pkg/reconciler/managed/api.go) This custom implementation is currently used in all controllers to revert back to the behavior before this breaking change from crossplane-runtime:v1.14.0 (https://github.com/crossplane/crossplane-runtime/pull/526) See also https://github.com/crossplane-contrib/provider-aws/pull/1953 for more information |
|
version
Package version contains the version of provider-aws repo
|
Package version contains the version of provider-aws repo |
Click to show internal directories.
Click to hide internal directories.