add iot module (#1567)

quarkiverse · Feb 2, 2025 · 564fa05 · 564fa05
1 parent cb3148d
commit 564fa05
Show file tree

Hide file tree

Showing 17 changed files with 4,899 additions and 0 deletions.
diff --git a/README.md b/README.md
@@ -20,6 +20,7 @@ This set of extensions allows you to interact with some of the AWS Services name
  * EventBridge
  * IAM
  * Inspector / Inspector2
+ * IoT
  * Kinesis
  * KMS
  * Lambda

diff --git a/bom/pom.xml b/bom/pom.xml
@@ -227,6 +227,16 @@
                 <artifactId>quarkus-amazon-inspector2</artifactId>
                 <version>${project.version}</version>
             </dependency>
+            <dependency>
+                <groupId>io.quarkiverse.amazonservices</groupId>
+                <artifactId>quarkus-amazon-iot-deployment</artifactId>
+                <version>${project.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.quarkiverse.amazonservices</groupId>
+                <artifactId>quarkus-amazon-iot</artifactId>
+                <version>${project.version}</version>
+            </dependency>
             <dependency>
                 <groupId>io.quarkiverse.amazonservices</groupId>
                 <artifactId>quarkus-amazon-inspector2-deployment</artifactId>

diff --git a/docs/modules/ROOT/nav.adoc b/docs/modules/ROOT/nav.adoc
@@ -11,6 +11,7 @@
 * xref:amazon-iam.adoc[IAM]
 * xref:amazon-inspector.adoc[Inspector]
 * xref:amazon-inspector2.adoc[Inspector2]
+* xref:amazon-iot.adoc[IoT]
 * xref:amazon-kinesis.adoc[Kinesis]
 * xref:amazon-kms.adoc[KMS]
 * xref:amazon-lambda.adoc[Lambda]

diff --git a/docs/modules/ROOT/pages/amazon-iot.adoc b/docs/modules/ROOT/pages/amazon-iot.adoc
@@ -0,0 +1,17 @@
+= Amazon IoT Client
+
+include::./includes/attributes.adoc[]
+
+AWS offers Internet of Things (IoT) services and solutions to connect and manage billions of devices. Collect, store, and analyze IoT data for industrial, consumer, commercial, and automotive workloads.
+
+You can find more information about IoT at https://aws.amazon.com/iot/[the Amazon IoT website].
+
+NOTE: The IoT extension is based on https://docs.aws.amazon.com/sdk-for-java/v2/developer-guide/welcome.html[AWS Java SDK 2.x].
+It's a major rewrite of the 1.x code base that offers two programming models (Blocking & Async).
+
+The Quarkus extension supports two programming models:
+
+* Blocking access using URL Connection HTTP client (by default) or the Apache HTTP Client
+* https://docs.aws.amazon.com/sdk-for-java/v2/developer-guide/basics-async.html[Asynchronous programming] based on JDK's `CompletableFuture` objects and the Netty HTTP client (by default) or the AWS CRT-based HTTP client
+
+include::./includes/quarkus-amazon-iot.adoc[]