Browse Source

docs: adjust references between ECS "migrate" and "install" pages

pull/11048/head
Paul Glass 3 years ago
parent
commit
392919ae61
  1. 13
      website/content/docs/ecs/get-started/install.mdx
  2. 11
      website/content/docs/ecs/get-started/migrate-existing-tasks.mdx

13
website/content/docs/ecs/get-started/install.mdx

@ -65,7 +65,12 @@ however there are some important inputs worth highlighting:
- `retry_join` is passed to the [`-retry-join`](/docs/agent/options#_retry_join) option for the Consul agent. This tells - `retry_join` is passed to the [`-retry-join`](/docs/agent/options#_retry_join) option for the Consul agent. This tells
the agent the location of your Consul server so that it can join the Consul cluster. the agent the location of your Consul server so that it can join the Consul cluster.
To define an ECS service, reference the mesh-task module's `task_definition_arn` output value -> **NOTE:** If your tasks run in a public subnet, they must have `assign_public_ip = true`
in their [`network_configuration`](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/ecs_service#network_configuration) block so that ECS can pull the Docker images.
## ECS Service
To define an ECS Service, reference the mesh-task module's `task_definition_arn` output value
in your `aws_ecs_service` resource: in your `aws_ecs_service` resource:
```hcl ```hcl
@ -75,9 +80,6 @@ resource "aws_ecs_service" "my_task" {
} }
``` ```
-> **NOTE:** If your tasks run in a public subnet, they must have `assign_public_ip = true`
in their [`network_configuration`](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/ecs_service#network_configuration) block so that ECS can pull the Docker images.
After running `terraform apply`, you should see your tasks registered in After running `terraform apply`, you should see your tasks registered in
the Consul UI. the Consul UI.
@ -94,7 +96,6 @@ proxy on that port.
For example, if your application `web` makes calls to another application called `backend`, then you would first configure the `mesh-task` module's upstream(s): For example, if your application `web` makes calls to another application called `backend`, then you would first configure the `mesh-task` module's upstream(s):
`backend`. `backend`.
```hcl ```hcl
module "web" { module "web" {
family = "web" family = "web"
@ -178,7 +179,7 @@ python manage.py runserver "127.0.0.1:8080"
## Next Steps ## Next Steps
- Configure a secure [Production Installation](TODO-LINK). - Configure a secure [Production Installation](/docs/ecs/production-installation).
- Now that your applications are running in the service mesh, read about - Now that your applications are running in the service mesh, read about
other [Service Mesh features](/docs/connect). other [Service Mesh features](/docs/connect).
- View the [Architecture](/docs/ecs/architecture) documentation to understand - View the [Architecture](/docs/ecs/architecture) documentation to understand

11
website/content/docs/ecs/get-started/migrate-existing-tasks.mdx

@ -98,7 +98,8 @@ module "my_task" {
The main differences are: The main differences are:
- You must remove the `execution_role_arn` and `task_role_arn` fields. The `mesh-task` module will create the task and execution roles. - You must remove the `execution_role_arn` and `task_role_arn` fields. The `mesh-task` module will create the task and execution roles.
- You must add the `port` field. This is the port that your application listens on. - You must set the `port` field to the port that your application listens on.
If your application has no listening port, set `outbound_only = true` and remove the `port` field.
- You must add the `retry_join` field. This specifies the location of your Consul servers so that your task can join the mesh. - You must add the `retry_join` field. This specifies the location of your Consul servers so that your task can join the mesh.
- You must remove the `jsonencode()` function from the `container_definitions` field. - You must remove the `jsonencode()` function from the `container_definitions` field.
@ -106,5 +107,9 @@ The `mesh-task` module will create a new version of your task definition with th
necessary sidecar containers added so you can delete your existing `aws_ecs_task_definition` necessary sidecar containers added so you can delete your existing `aws_ecs_task_definition`
resource. resource.
Now that your task(s) are migrated to the `mesh-task` module, see the [Installation Guide](/docs/ecs/get-started/install) to continue installing ## Next Steps
Consul on ECS.
Now that your task(s) are migrated to the `mesh-task` module,
- Start at the [ECS Service section](/docs/ecs/get-started/install#ecs-service) of the Installation Guide to continue installing Consul on ECS.
- Refer to the [`mesh-task` reference documentation](https://registry.terraform.io/modules/hashicorp/consul-ecs/aws/latest/submodules/mesh-task?tab=inputs) for all available inputs to your mesh tasks.

Loading…
Cancel
Save