Skip to content

Commit d953ec0

Browse files
authored
Merge pull request #5 from AutoMQ/yifei_docs
feat: Yifei docs
2 parents 0af3fe7 + 5540b0c commit d953ec0

File tree

3 files changed

+30
-11
lines changed

3 files changed

+30
-11
lines changed

README.md

Lines changed: 15 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,18 +5,18 @@ This module is designed for deploying the AutoMQ BYOC (Bring Your Own Cloud) env
55

66
Upon completion of the installation, the module will output the endpoint of the AutoMQ BYOC environment along with the initial username and password. Users can manage the resources within the environment through the following two methods:
77

8-
- **Using the Web UI to manage resources**: This method allows users to manage instances, topics, ACLs, and other resources through a web-based interface.
8+
- **Using the Web UI to manage resources**: This method allows users to manage instances, topics, ACLs, and other resources through a web-ui.
99
- **Using Terraform to manage resources**: This method requires users to access the AutoMQ BYOC environment via a web browser for the first time to create a Service Account. Subsequently, users can manage resources within the environment using the Service Account's Access Key and the AutoMQ Terraform Provider.
1010

1111
For managing instances, topics, and other resources within the AutoMQ BYOC environment using the AutoMQ Terraform Provider, please refer to the [documentation](https://docs.automq.com/automq-cloud/manage-identities-and-access).
1212

1313
# Module Usage
1414
Use this module to install the AutoMQ BYOC environment, supporting two modes:
1515

16-
- **Create a new VPC and install**: Recommended only for POC or other testing scenarios. In this mode, the user only needs to specify the region, and resources including VPC, Endpoint, Security Group, S3 Bucket, etc., will be created. After testing, all resources can be destroyed with one click.
17-
- **Install using an existing VPC**: Recommended for production environments. In this mode, the user needs to provide a VPC, subnet, and S3 Bucket that meet the requirements. AutoMQ will deploy the BYOC environment console to the user-specified subnet.
16+
- **Create a new VPC**: Recommended only for POC or other testing scenarios. In this mode, the user only needs to specify the region, and resources including VPC, Endpoint, Security Group, S3 Bucket, etc., will be created. After testing, all resources can be destroyed with one click.
17+
- **Using an existing VPC**: Recommended for production environments. In this mode, the user needs to provide a VPC, subnet, and S3 Bucket that meet the requirements. AutoMQ will deploy the BYOC environment console to the user-specified subnet.
1818

19-
## Create a new VPC and install
19+
## Create a new VPC
2020

2121
```terraform
2222
module "automq_byoc" {
@@ -30,7 +30,7 @@ module "automq_byoc" {
3030
}
3131
```
3232

33-
## Install using an existing VPC
33+
## Using an existing VPC
3434

3535
To install the AutoMQ BYOC environment using an existing VPC, ensure your existing VPC meets the necessary requirements. You can find the detailed requirements in the [doc](https://docs.automq.com/zh/automq-cloud/getting-started/create-byoc-environment/aws/step-1-installing-env-with-ami#%E6%AD%A5%E9%AA%A4-3%E5%90%AF%E5%8A%A8-ec2-%E5%AE%9E%E4%BE%8B%E5%AE%89%E8%A3%85%E7%8E%AF%E5%A2%83).
3636

@@ -56,6 +56,16 @@ module "automq_byoc" {
5656
}
5757
```
5858

59+
# Helpful Links/Information
60+
61+
* [Report Bugs](https://github.com/AutoMQ/terraform-aws-automq-byoc-environmet/issues)
62+
63+
* [Documents](https://docs.automq.com/automq-cloud/overview)
64+
65+
* [Request Features](https://automq66.feishu.cn/share/base/form/shrcn7qXbb5aKiYbKqbJtPlGWXc)
66+
67+
68+
5969
<!-- BEGIN_TF_DOCS -->
6070
## Requirements
6171

README.tmpl.md

Whitespace-only changes.

README.tpl.md

Lines changed: 15 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,22 @@
11
# AWS AutoMQ BYOC Environment Terrafrom module
2+
![Preview](https://img.shields.io/badge/Lifecycle_Stage-Preview-blue?style=flat&logoColor=8A3BE2&labelColor=rgba)
23

34
This module is designed for deploying the AutoMQ BYOC (Bring Your Own Cloud) environment using the AWS Provider within an AWS cloud environment.
45

56
Upon completion of the installation, the module will output the endpoint of the AutoMQ BYOC environment along with the initial username and password. Users can manage the resources within the environment through the following two methods:
67

7-
- **Using the Web UI to manage resources**: This method allows users to manage instances, topics, ACLs, and other resources through a web-based interface.
8+
- **Using the Web UI to manage resources**: This method allows users to manage instances, topics, ACLs, and other resources through a web-ui.
89
- **Using Terraform to manage resources**: This method requires users to access the AutoMQ BYOC environment via a web browser for the first time to create a Service Account. Subsequently, users can manage resources within the environment using the Service Account's Access Key and the AutoMQ Terraform Provider.
910

1011
For managing instances, topics, and other resources within the AutoMQ BYOC environment using the AutoMQ Terraform Provider, please refer to the [documentation](https://docs.automq.com/automq-cloud/manage-identities-and-access).
1112

1213
# Module Usage
1314
Use this module to install the AutoMQ BYOC environment, supporting two modes:
1415

15-
- **Create a new VPC and install**: Recommended only for POC or other testing scenarios. In this mode, the user only needs to specify the region, and resources including VPC, Endpoint, Security Group, S3 Bucket, etc., will be created. After testing, all resources can be destroyed with one click.
16-
- **Install using an existing VPC**: Recommended for production environments. In this mode, the user needs to provide a VPC, subnet, and S3 Bucket that meet the requirements. AutoMQ will deploy the BYOC environment console to the user-specified subnet.
16+
- **Create a new VPC**: Recommended only for POC or other testing scenarios. In this mode, the user only needs to specify the region, and resources including VPC, Endpoint, Security Group, S3 Bucket, etc., will be created. After testing, all resources can be destroyed with one click.
17+
- **Using an existing VPC**: Recommended for production environments. In this mode, the user needs to provide a VPC, subnet, and S3 Bucket that meet the requirements. AutoMQ will deploy the BYOC environment console to the user-specified subnet.
1718

18-
## Create a new VPC and install
19+
## Create a new VPC
1920

2021
```terraform
2122
module "automq_byoc" {
@@ -29,7 +30,7 @@ module "automq_byoc" {
2930
}
3031
```
3132

32-
## Install using an existing VPC
33+
## Using an existing VPC
3334

3435
To install the AutoMQ BYOC environment using an existing VPC, ensure your existing VPC meets the necessary requirements. You can find the detailed requirements in the [doc](https://docs.automq.com/zh/automq-cloud/getting-started/create-byoc-environment/aws/step-1-installing-env-with-ami#%E6%AD%A5%E9%AA%A4-3%E5%90%AF%E5%8A%A8-ec2-%E5%AE%9E%E4%BE%8B%E5%AE%89%E8%A3%85%E7%8E%AF%E5%A2%83).
3536

@@ -53,4 +54,12 @@ module "automq_byoc" {
5354
automq_byoc_env_console_public_subnet_id = "subnet-09500xxxxxb6fd28"
5455
5556
}
56-
```
57+
```
58+
59+
# Helpful Links/Information
60+
61+
* [Report Bugs](https://github.com/AutoMQ/terraform-aws-automq-byoc-environmet/issues)
62+
63+
* [Documents](https://docs.automq.com/automq-cloud/overview)
64+
65+
* [Request Features](https://automq66.feishu.cn/share/base/form/shrcn7qXbb5aKiYbKqbJtPlGWXc)

0 commit comments

Comments
 (0)