Skip to content

Commit d20bf06

Browse files
committed
Tutorial content post review MC update
1 parent 1a9564b commit d20bf06

File tree

1 file changed

+8
-24
lines changed
  • content/arduino-cloud/09.business/02.aws-s3-exporter

1 file changed

+8
-24
lines changed

content/arduino-cloud/09.business/02.aws-s3-exporter/content.md

+8-24
Original file line numberDiff line numberDiff line change
@@ -35,8 +35,8 @@ At the end of this tutorial, the stack will be configured to extract data from A
3535

3636
## Required Software
3737

38-
* [Arduino Cloud](https://cloud.arduino.cc/). **If you do not have an account, you can create one for free in [cloud.arduino.cc](https://cloud.arduino.cc/home/?get-started=true)**.
39-
* [AWS CLI](https://aws.amazon.com/cli/). **If you do not have an AWS account, please refer to the [online AWS documentation](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html)**.
38+
* [Arduino Cloud](https://cloud.arduino.cc/). If you do not have an account, you can create one for free in [cloud.arduino.cc](https://cloud.arduino.cc/home/?get-started=true).
39+
* [AWS Account](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html#sign-up-for-aws). If you do not have an AWS account yet, please refer to the [online AWS documentation](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html) to create one. Once your account is set up, you'll need to ensure it has the appropriate IAM permissions to deploy Lambda functions and other resources, as detailed in the [AWS Account & CloudFormation Template](#aws-account--cloudformation-template) section below.
4040
* [Go Programming Language](https://go.dev/) (version 1.22 or higher) (Optional)
4141
* [Official Arduino AWS S3 CSV Exporter Repository](https://github.com/arduino/aws-s3-integration)
4242

@@ -56,12 +56,12 @@ This setup provides a structured and scalable approach for managing time series
5656

5757
An active AWS account is required to deploy the **Arduino AWS S3 CSV Exporter**. If an account is unavailable, refer to the [online AWS documentation](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html) for account setup. The following steps can help you get started:
5858

59-
- [Sign up for an AWS account](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html#aws-registration)
59+
- [Sign up for an AWS account](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html#sign-up-for-aws)
6060
- [Create an administrative user](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html#create-an-admin)
6161

6262
The exporter setup involves deploying resources using a [**CloudFormation template**](https://github.com/arduino/aws-s3-integration/blob/0.3.0/deployment/cloud-formation-template/deployment.yaml). This template provisions and configures the necessary AWS resources automatically.
6363

64-
AWS CloudFormation requires specific [**IAM permissions**](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html) to automatically provision and manage AWS resources during this deployment. AWS Identity and Access Management (IAM) is a web service that helps you securely control access to AWS resources by managing permissions and determining which resources users can access.
64+
AWS CloudFormation requires specific [**IAM permissions**](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html) to automatically provision and manage AWS resources during this deployment. **AWS Identity and Access Management (IAM)** is a web service that helps you securely control access to AWS resources by managing permissions and determining which resources users can access.
6565

6666
* CloudFormation stack creation (policy: `AWSCloudFormationFullAccess`)
6767
* S3 bucket management (policy: `AmazonS3FullAccess`)
@@ -142,14 +142,16 @@ A second bucket must be created following the same process as the [Temporary buc
142142

143143
Navigate to the **Amazon S3** service and select **Create bucket**. In the bucket creation window, specify the bucket name and check that the same AWS region is selected.
144144

145-
To maintain security compliance, keep the recommended default settings for **Object Ownership** and **Public Access**. Once all settings are verified, you can create the bucket.
145+
For security best practices, you can use the default **Object Ownership** and **Block Public Access** settings, which keep the bucket private and secure.
146146

147147
![lambdas3binaries Bucket Setup (1)](assets/s3_bucket_csvdests3int_1.png)
148148

149149
After the bucket has been successfully created, it will be listed among the available S3 buckets. If necessary, you can select the newly created **CSV destination bucket** to proceed with additional configurations.
150150

151151
![lambdas3binaries Bucket Setup (2)](assets/s3_bucket_csvdests3int_2.png)
152152

153+
***While you can organize files by creating directories within the CSV destination bucket, this is _optional_ for the exporter to function properly. The exporter will automatically create the necessary structure for storing CSV files.***
154+
153155
Inside the **CSV destination bucket**, navigate to the **Objects** tab. If necessary, you can organize files by creating directories.
154156

155157
Click on the **Create folder** button and specify a name for the directory where the exported CSV files will be stored.
@@ -424,25 +426,7 @@ Together, these services provide the tools to track performance, detect errors a
424426

425427
## Building the Code (Optional)
426428

427-
The [**AWS S3 CSV Exporter repository**](https://github.com/arduino/aws-s3-integration/tree/0.3.0) contains the source code required to build and deploy the exporter. While precompiled binaries are available, building the exporter locally allows customization and testing before deployment.
428-
429-
### Building Locally
430-
431-
To build the AWS S3 CSV Exporter, make sure that at least [**Go version 1.22**](https://go.dev/) is installed. The exporter can be compiled using:
432-
433-
```bash
434-
./compile-lambda.sh
435-
```
436-
437-
This script creates an **`arduino-s3-integration-lambda.zip`** file, which is the packaged Lambda function ready for deployment.
438-
439-
Alternatively, the following command can be used to build the exporter:
440-
441-
```bash
442-
task go:build
443-
```
444-
445-
This approach is useful for developers who want to test or modify the exporter before deploying it using AWS CloudFormation.
429+
The [**AWS S3 CSV Exporter repository**](https://github.com/arduino/aws-s3-integration/tree/0.3.0) contains the source code required to build and deploy the exporter. While precompiled binaries are available, building the exporter locally allows customization and testing before deployment. Please refer to the [AWS S3 CSV Exporter repository](https://github.com/arduino/aws-s3-integration/tree/0.3.0) documentation for information about building the code locally.
446430

447431
## Additional Documentation
448432

0 commit comments

Comments
 (0)