Skip to content

Commit

Permalink
Update secure public access instructions (#174)
Browse files Browse the repository at this point in the history
* Add sg to vpce and troubleshooting instructions

* fix aws reference sidebar
  • Loading branch information
vordimous authored Jan 17, 2024
1 parent 10fa443 commit aa2492d
Show file tree
Hide file tree
Showing 5 changed files with 164 additions and 7 deletions.
4 changes: 2 additions & 2 deletions src/.vuepress/sidebar/en.ts
Original file line number Diff line number Diff line change
Expand Up @@ -78,8 +78,8 @@ export const enSidebar = sidebar({
],
},
{
text: "Amazon MSK",
prefix: "amazon-msk/",
text: "AWS",
prefix: "aws/",
children: "structure",
},
{
Expand Down
39 changes: 38 additions & 1 deletion src/how-tos/amazon-msk/secure-public-access/development.md
Original file line number Diff line number Diff line change
Expand Up @@ -259,6 +259,8 @@ When your <ZillaPlus/> proxy is ready, the [CloudFormation console](https://cons

## Verify <ZillaPlus/> proxy Service

> This checks that the services and networking were properly configured.
Navigate to the [EC2 running instances dashboard.](https://console.aws.amazon.com/ec2/home#Instances:instanceState=running)

::: note Check your selected region
Expand Down Expand Up @@ -334,7 +336,42 @@ Cloud-init v. 22.2.2 running 'init'...

:::

Repeat these steps for each of the other <ZillaPlus/> proxies launched by the CloudFormation template.
Check the networking of the <ZillaPlus/> proxy instances to MSK.

::: tabs

@tab DNS resolving

Verify that the instance can resolve the private Route53 DNS address.

```bash:no-line-numbers
nslookup *.aklivity.[...].amazonaws.com
```

```output:no-line-numbers
Server: ***
Address: ***
Non-authoritative answer:
Name: *.aklivity.[...].amazonaws.com
Address: ***
```

@tab Check Ports

Check the communication over necessary ports with `netcat`.

```bash:no-line-numbers
nc -vz *.aklivity.[...].amazonaws.com 9096
```

```output:no-line-numbers
Connection to *.aklivity.[...].amazonaws.com port 9096 [tcp/italk] succeeded!
```

:::

Repeat these steps for each of the other <ZillaPlus/> proxies launched by the CloudFormation template if necessary.

## Verify Kafka Client Connectivity

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -293,6 +293,8 @@ When your <ZillaPlus/> proxy is ready, the [CloudFormation console](https://cons

## Verify <ZillaPlus/> proxy Service

> This checks that the services and networking were properly configured.
Navigate to the [EC2 running instances dashboard.](https://console.aws.amazon.com/ec2/home#Instances:instanceState=running)

::: note Check your selected region
Expand Down Expand Up @@ -369,7 +371,42 @@ Cloud-init v. 22.2.2 running 'init'...

:::

Repeat these steps for each of the other <ZillaPlus/> proxies launched by the CloudFormation template.
Check the networking of the <ZillaPlus/> proxy instances to MSK.

::: tabs

@tab DNS resolving

Verify that the instance can resolve the private Route53 DNS address.

```bash:no-line-numbers
nslookup *.aklivity.[...].amazonaws.com
```

```output:no-line-numbers
Server: ***
Address: ***
Non-authoritative answer:
Name: *.aklivity.[...].amazonaws.com
Address: ***
```

@tab Check Ports

Check the communication over necessary ports with `netcat`.

```bash:no-line-numbers
nc -vz *.aklivity.[...].amazonaws.com 9094
```

```output:no-line-numbers
Connection to *.aklivity.[...].amazonaws.com port 9094 [tcp/italk] succeeded!
```

:::

Repeat these steps for each of the other <ZillaPlus/> proxies launched by the CloudFormation template if necessary.

### Configure Global DNS

Expand Down
39 changes: 38 additions & 1 deletion src/how-tos/amazon-msk/secure-public-access/production.md
Original file line number Diff line number Diff line change
Expand Up @@ -267,6 +267,8 @@ When your <ZillaPlus/> proxy is ready, the [CloudFormation console](https://cons

## Verify <ZillaPlus/> proxy Service

> This checks that the services and networking were properly configured.
Navigate to the [EC2 running instances dashboard.](https://console.aws.amazon.com/ec2/home#Instances:instanceState=running)

::: note Check your selected region
Expand Down Expand Up @@ -343,7 +345,42 @@ Cloud-init v. 22.2.2 running 'init'...

:::

Repeat these steps for each of the other <ZillaPlus/> proxies launched by the CloudFormation template.
Check the networking of the <ZillaPlus/> proxy instances to MSK.

::: tabs

@tab DNS resolving

Verify that the instance can resolve the private Route53 DNS address.

```bash:no-line-numbers
nslookup *.aklivity.[...].amazonaws.com
```

```output:no-line-numbers
Server: ***
Address: ***
Non-authoritative answer:
Name: *.aklivity.[...].amazonaws.com
Address: ***
```

@tab Check Ports

Check the communication over necessary ports with `netcat`.

```bash:no-line-numbers
nc -vz *.aklivity.[...].amazonaws.com 9096
```

```output:no-line-numbers
Connection to *.aklivity.[...].amazonaws.com port 9096 [tcp/italk] succeeded!
```

:::

Repeat these steps for each of the other <ZillaPlus/> proxies launched by the CloudFormation template if necessary.

### Configure Global DNS

Expand Down
50 changes: 48 additions & 2 deletions src/how-tos/confluent-cloud/secure-public-access.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ Now you will need to [Setup AWS PrivateLink](https://docs.aws.amazon.com/vpc/lat
- Subnets: Select `public` subnets for each availability zone
- Create the Endpoint

Finish the `zilla_plus_privatelink_service` connection wizard with the `PrivateLink Endpoint ID` found in your `my-cce-privatelink-vpce` from the [Endpoints table](https://console.aws.amazon.com/vpcconsole/home#Endpoints:)
Finish the `zilla_plus_privatelink_service` connection wizard with the `PrivateLink Endpoint ID` found in your `my-cce-privatelink-vpce` from the [Endpoints table](https://console.aws.amazon.com/vpcconsole/home#Endpoints:).

### Create the Route53 Hosted zone

Expand Down Expand Up @@ -131,6 +131,15 @@ Navigate to the VPC Management Console [Security Groups](https://console.aws.ama
- Source type: `Custom`
- Source: `my-zilla-proxy-sg`

Add the `my-zilla-proxy-sg` security group to your VPC Endpoint by finding your `my-cce-privatelink-vpce` from the [Endpoints table](https://console.aws.amazon.com/vpcconsole/home#Endpoints:).

- Select your VPC endpoint
- `Actions` menu > select `Manage Security Groups`
- Select both security groups:
- `default`
- `my-zilla-proxy-sg`
- Save the changes

### Create the <ZillaPlus/> proxy IAM security role

> This creates an IAM security role to enable the required AWS services for the <ZillaPlus/> proxies.
Expand Down Expand Up @@ -282,6 +291,8 @@ When your <ZillaPlus/> proxy is ready, the [CloudFormation console](https://cons

## Verify <ZillaPlus/> proxy Service

> This checks that the services and networking were properly configured.
Navigate to the [EC2 running instances dashboard.](https://console.aws.amazon.com/ec2/home#Instances:instanceState=running)

::: note Check your selected region
Expand Down Expand Up @@ -357,7 +368,42 @@ Cloud-init v. 22.2.2 running 'init'...

:::

Repeat these steps for each of the other <ZillaPlus/> proxies launched by the CloudFormation template.
Check the networking of the <ZillaPlus/> proxy instances to confluent cloud.

::: tabs

@tab DNS resolving

Verify that the instance can resolve the private Route53 DNS address.

```bash:no-line-numbers
nslookup <Cluster ID>.<Region>.aws.private.confluent.cloud
```

```output:no-line-numbers
Server: ***
Address: ***
Non-authoritative answer:
Name: <Cluster ID>.<Region>.aws.private.confluent.cloud
Address: ***
```

@tab Check Ports

Check the communication over necessary ports with `netcat`.

```bash:no-line-numbers
nc -vz <Cluster ID>.<Region>.aws.private.confluent.cloud 9092
```

```output:no-line-numbers
Connection to <Cluster ID>.<Region>.aws.private.confluent.cloud port 9092 [tcp/italk] succeeded!
```

:::

Repeat these steps for each of the other <ZillaPlus/> proxies launched by the CloudFormation template if necessary.

### Configure Global DNS

Expand Down

0 comments on commit aa2492d

Please sign in to comment.