From 4519a5a89844b18b8fad4aa02de2d2eceb012227 Mon Sep 17 00:00:00 2001
From: Collen <collen@gitlab.com>
Date: Thu, 9 Apr 2020 13:35:43 +0000
Subject: [PATCH] Update auto scaling steps
---
doc/install/aws/img/choose_ami.png | Bin 4888 -> 0 bytes
doc/install/aws/index.md | 113 ++++++++++-------------------
2 files changed, 39 insertions(+), 74 deletions(-)
delete mode 100644 doc/install/aws/img/choose_ami.png
diff --git a/doc/install/aws/img/choose_ami.png b/doc/install/aws/img/choose_ami.png
deleted file mode 100644
index a07d42dd6fb3b480bc6a7c2da3f43fa5744b7ee6..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 4888
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
diff --git a/doc/install/aws/index.md b/doc/install/aws/index.md
index 128d0746df2f0..92a5286a1321a 100644
--- a/doc/install/aws/index.md
+++ b/doc/install/aws/index.md
@@ -580,90 +580,55 @@ On the EC2 dashboard:
Now we have a custom AMI that we'll use to create our launch configuration the the next step.
-## Deploying GitLab inside an auto scaling group
+## Deploy GitLab inside an auto scaling group
-We'll use AWS's wizard to deploy GitLab and then SSH into the instance to
-configure the PostgreSQL and Redis connections.
+### Create a launch configuration
-The Auto Scaling Group option is available through the EC2 dashboard on the left
-sidebar.
-
-1. Click **Create Auto Scaling group**.
-1. Create a new launch configuration.
-
-### Choose the AMI
-
-Choose the AMI:
-
-1. Go to the Community AMIs and search for `GitLab EE <version>`
- where `<version>` the latest version as seen on the
- [releases page](https://about.gitlab.com/releases/).
-
- 
-
-### Choose an instance type
-
-You should choose an instance type based on your workload. Consult
-[the hardware requirements](../requirements.md#hardware-requirements) to choose
-one that fits your needs (at least `c5.xlarge`, which is enough to accommodate 100 users):
-
-1. Choose the your instance type.
-1. Click **Next: Configure Instance Details**.
-
-### Configure details
-
-In this step we'll configure some details:
-
-1. Enter a name (`gitlab-autoscaling`).
-1. Select the IAM role we created.
-1. Optionally, enable CloudWatch and the EBS-optimized instance settings.
-1. In the "Advanced Details" section, set the IP address type to
- "Do not assign a public IP address to any instances."
-1. Click **Next: Add Storage**.
-
-### Add storage
-
-The root volume is 8GB by default and should be enough given that we won't store any data there.
-
-### Configure security group
-
-As a last step, configure the security group:
-
-1. Select the existing load balancer security group we have [created](#load-balancer).
-1. Select **Review**.
-
-### Review and launch
-
-Now is a good time to review all the previous settings. When ready, click
-**Create launch configuration** and select the SSH key pair with which you will
-connect to the instance.
-
-### Create Auto Scaling Group
-
-We are now able to start creating our Auto Scaling Group:
-
-1. Give it a group name.
-1. Set the group size to 2 as we want to always start with two instances.
-1. Assign it our network VPC and add the **private subnets**.
-1. In the "Advanced Details" section, choose to receive traffic from ELBs
- and select our ELB.
-1. Choose the ELB health check.
-1. Click **Next: Configure scaling policies**.
+From the EC2 dashboard:
-This is the really great part of Auto Scaling; we get to choose when AWS
-launches new instances and when it removes them. For this group we'll
-scale between 2 and 4 instances where one instance will be added if CPU
+1. Select **Launch Configurations** from the left menu and click **Create launch configuration**.
+1. Select **My AMIs** from the left menu and select the `GitLab` custom AMI we created above.
+1. Select an instance type best suited for your needs (at least a `c5.xlarge`) and click **Configure details**.
+1. Enter a name for your launch configuration (we'll use `gitlab-ha-launch-config`).
+1. **Do not** check **Request Spot Instance**.
+1. From the **IAM Role** dropdown, pick the `GitLabAdmin` instance role we [created earlier](#creating-an-iam-ec2-instance-role-and-profile).
+1. Leave the rest as defaults and click **Add Storage**.
+1. The root volume is 8GiB by default and should be enough given that we won’t store any data there. Click **Configure Security Group**.
+1. Check **Select and existing security group** and select the `gitlab-loadbalancer-sec-group` we created earlier.
+1. Click **Review**, review your changes, and click **Create launch configuration**.
+1. Acknowledge that you have access to the private key or create a new one. Click **Create launch configuration**.
+
+### Create an auto scaling group
+
+1. As soon as the launch configuration is created, you'll see an option to **Create an Auto Scaling group using this launch configuration**. Click that to start creating the auto scaling group.
+1. Enter a **Group name** (we'll use `gitlab-auto-scaling-group`).
+1. For **Group size**, enter the number of instances you want to start with (we'll enter `2`).
+1. Select the `gitlab-vpc` from the **Network** dropdown.
+1. Add both the private [subnets we created earlier](#subnets).
+1. Expand the **Advanced Details** section and check the **Receive traffic from one or more load balancers** option.
+1. From the **Classic Load Balancers** dropdown, Select the load balancer we created earlier.
+1. For **Health Check Type**, select **ELB**.
+1. We'll leave our **Health Check Grace Period** as the default `300` seconds. Click **Configure scaling policies**.
+1. Check **Use scaling policies to adjust the capacity of this group**.
+1. For this group we'll scale between 2 and 4 instances where one instance will be added if CPU
utilization is greater than 60% and one instance is removed if it falls
to less than 45%.
-Finally, configure notifications and tags as you see fit, and create the
+1. Finally, configure notifications and tags as you see fit, review your changes, and create the
auto scaling group.
-You'll notice that after we save the configuration, AWS starts launching our two
-instances in different AZs and without a public IP which is exactly what
-we intended.
+As the auto scaling group is created, you'll see your new instances spinning up in your EC2 dashboard. You'll also see the new instances added to your load balancer. Once the instances pass the heath check, they are ready to start receiving traffic from the load balancer.
+
+Since our instances are created by the auto scaling group, go back to your instances and terminate the [instance we created manually above](#install-gitlab). We only needed this instance to create our custom AMI.
+
+### Log in for the first time
+
+Using the domain name you used when setting up [DNS for the load balancer](#configure-dns-for-load-balancer), you should now be able to visit GitLab in your browser. The very first time you will be asked to set up a password
+for the `root` user which has admin privileges on the GitLab instance.
+
+After you set it up, login with username `root` and the newly created password.
## Health check and monitoring with Prometheus
--
GitLab