This is an automated email from the ASF dual-hosted git repository.
acosentino pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/camel.git
commit 1a9eb089075db782d6204a73d83a9f30ea797201
Author: Andrea Cosentino <anco...@gmail.com>
AuthorDate: Fri Dec 21 15:15:16 2018 +0100
CAMEL-13027 - Added docs
---
.../camel-aws/src/main/docs/aws-eks-component.adoc | 172 +++++++++++++++++++++
1 file changed, 172 insertions(+)
diff --git a/components/camel-aws/src/main/docs/aws-eks-component.adoc
b/components/camel-aws/src/main/docs/aws-eks-component.adoc
new file mode 100644
index 0000000..fc26e31
--- /dev/null
+++ b/components/camel-aws/src/main/docs/aws-eks-component.adoc
@@ -0,0 +1,172 @@
+[[aws-eks-component]]
+== AWS EKS Component
+
+*Available as of Camel version 3.0*
+
+The EKS component supports create, delete, describe and list
+https://aws.amazon.com/it/kms/[AWS EKS] clusters instances.
+
+Prerequisites
+
+You must have a valid Amazon Web Services developer account, and be
+signed up to use Amazon KMS. More information are available at
+https://aws.amazon.com/eks/[Amazon EKS].
+
+### URI Format
+
+[source,java]
+-------------------------
+aws-eks://label[?options]
+-------------------------
+
+You can append query options to the URI in the following format,
+?options=value&option2=value&...
+
+### URI Options
+
+
+// component options: START
+The AWS EKS component supports 5 options, which are listed below.
+
+
+
+[width="100%",cols="2,5,^1,2",options="header"]
+|===
+| Name | Description | Default | Type
+| *configuration* (advanced) | The AWS KMS default configuration | |
EKSConfiguration
+| *accessKey* (producer) | Amazon AWS Access Key | | String
+| *secretKey* (producer) | Amazon AWS Secret Key | | String
+| *region* (producer) | The region in which KMS client needs to work | |
String
+| *resolveProperty Placeholders* (advanced) | Whether the component should
resolve property placeholders on itself when starting. Only properties which
are of String type can use property placeholders. | true | boolean
+|===
+// component options: END
+
+
+
+
+// endpoint options: START
+The AWS EKS endpoint is configured using URI syntax:
+
+----
+aws-eks:label
+----
+
+with the following path and query parameters:
+
+==== Path Parameters (1 parameters):
+
+
+[width="100%",cols="2,5,^1,2",options="header"]
+|===
+| Name | Description | Default | Type
+| *label* | *Required* Logical name | | String
+|===
+
+
+==== Query Parameters (8 parameters):
+
+
+[width="100%",cols="2,5,^1,2",options="header"]
+|===
+| Name | Description | Default | Type
+| *accessKey* (producer) | Amazon AWS Access Key | | String
+| *eksClient* (producer) | To use a existing configured AWS EKS as client | |
AmazonEKS
+| *operation* (producer) | *Required* The operation to perform | |
EKSOperations
+| *proxyHost* (producer) | To define a proxy host when instantiating the EKS
client | | String
+| *proxyPort* (producer) | To define a proxy port when instantiating the EKS
client | | Integer
+| *region* (producer) | The region in which EKS client needs to work | |
String
+| *secretKey* (producer) | Amazon AWS Secret Key | | String
+| *synchronous* (advanced) | Sets whether synchronous processing should be
strictly used, or Camel is allowed to use asynchronous processing (if
supported). | false | boolean
+|===
+// endpoint options: END
+// spring-boot-auto-configure options: START
+=== Spring Boot Auto-Configuration
+
+
+The component supports 12 options, which are listed below.
+
+
+
+[width="100%",cols="2,5,^1,2",options="header"]
+|===
+| Name | Description | Default | Type
+| *camel.component.aws-kms.access-key* | Amazon AWS Access Key | | String
+| *camel.component.aws-kms.configuration.access-key* | Amazon AWS Access Key |
| String
+| *camel.component.aws-kms.configuration.kms-client* | To use a existing
configured AWS KMS as client | | AWSKMS
+| *camel.component.aws-kms.configuration.operation* | The operation to perform
| | KMSOperations
+| *camel.component.aws-kms.configuration.proxy-host* | To define a proxy host
when instantiating the KMS client | | String
+| *camel.component.aws-kms.configuration.proxy-port* | To define a proxy port
when instantiating the KMS client | | Integer
+| *camel.component.aws-kms.configuration.region* | The region in which KMS
client needs to work | | String
+| *camel.component.aws-kms.configuration.secret-key* | Amazon AWS Secret Key |
| String
+| *camel.component.aws-kms.enabled* | Whether to enable auto configuration of
the aws-kms component. This is enabled by default. | | Boolean
+| *camel.component.aws-kms.region* | The region in which KMS client needs to
work | | String
+| *camel.component.aws-kms.resolve-property-placeholders* | Whether the
component should resolve property placeholders on itself when starting. Only
properties which are of String type can use property placeholders. | true |
Boolean
+| *camel.component.aws-kms.secret-key* | Amazon AWS Secret Key | | String
+|===
+// spring-boot-auto-configure options: END
+
+
+
+
+Required EKS component options
+
+You have to provide the amazonEKSClient in the
+Registry or your accessKey and secretKey to access
+the https://aws.amazon.com/eks/[Amazon EKS] service.
+
+### Usage
+
+#### Message headers evaluated by the EKS producer
+
+[width="100%",cols="10%,10%,80%",options="header",]
+|=======================================================================
+|Header |Type |Description
+
+|`CamelAwsEKSMaxResults` |`Integer` |The limit number of results while listing
clusters
+
+|`CamelAwsEKSOperation` |`String` |The operation we want to perform
+
+|`CamelAwsEKSDescription` |`String` |A key description to use while performing
a createKey operation
+
+|`CamelAwsEKSClusterName` |`String` |The cluster name
+
+|`CamelAwsEKSRoleARN` |`String` |The role ARN to use while creating the cluster
+
+|`CamelAwsEKSVPCConfig` |`VPCConfigRequest` |The VPC config for the creations
of an EKS cluster
+|=======================================================================
+
+#### EKS Producer operations
+
+Camel-AWS EKS component provides the following operation on the producer side:
+
+- listClusters
+- createCluster
+- describeCluster
+- deleteCluster
+
+Dependencies
+
+Maven users will need to add the following dependency to their pom.xml.
+
+*pom.xml*
+
+[source,xml]
+---------------------------------------
+<dependency>
+ <groupId>org.apache.camel</groupId>
+ <artifactId>camel-aws</artifactId>
+ <version>${camel-version}</version>
+</dependency>
+---------------------------------------
+
+where `${camel-version`} must be replaced by the actual version of Camel
+(3.0.0 or higher).
+
+### See Also
+
+* Configuring Camel
+* Component
+* Endpoint
+* Getting Started
+
+* AWS Component
