Skip to content

Commit f338b3b

Browse files
DaedalusGcloudyadi
DaedalusG
and
cloudyadi
authored
Sourcegraph AMIs: remove references to AMI T-shirt sizes (#1121)
We no longer publish images per instance T-shirt size. This PR removes those references from the deployment docs and moves them to a "how-to" so that they can still be referenced as needed. New reference image: <img width="1256" alt="Screenshot 2025-05-06 at 3 52 51 PM" src="https://github.com/user-attachments/assets/3c6170f7-2a70-4d5b-8fa4-38baccfda5dd" /> Tested deployment via EC2 account closes https://linear.app/sourcegraph/issue/REL-926/clean-up-ami-docs --------- Co-authored-by: Adi Ranjan <[email protected]>
1 parent 3bdaeb6 commit f338b3b

File tree

2 files changed

+22
-16
lines changed

2 files changed

+22
-16
lines changed

‎docs/admin/deploy/machine-images/aws-ami.mdx‎

Lines changed: 6 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -16,34 +16,24 @@ All Sourcegraph AMIs are published from one of the following AWS accounts:
1616
- Account ID: `870751268155`
1717

1818

19-
### Instance size chart
19+
### Instance sizing
2020

21-
Select an AMI according and instance type to the number of users and repositories you have using this table. If you fall between two sizes, choose the larger of the two.
22-
23-
For example, if you have 8,000 users with 80,000 repositories, your instance size would be **L**. If you have 1,000 users with 80,000 repositories, you should still go with size **M**.
24-
25-
| | **XS** | **S** | **M** | **L** | **XL** |
26-
|----------------------|---------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------|
27-
| **Users** | greater than or equal to 500 | greater than or equal to 1,000 | greater than or equal to 5,000 | greater than or equal to 10,000 | greater than or equal to 20,000 |
28-
| **Repositories** | greater than or equal to 5,000 | greater than or equal to 10,000 | greater than or equal to 50,000 | greater than or equal to 100,000 | greater than or equal to 250,000 |
29-
| **Recommended Type** | m6a.2xlarge | m6a.4xlarge | m6a.8xlarge | m6a.12xlarge | m6a.24xlarge |
30-
| **Minimum Type** | m6a.2xlarge | m6a.2xlarge | m6a.4xlarge | m6a.8xlarge | m6a.12xlarge |
31-
| **AMIs List** | [size-XS AMIs](https://console.aws.amazon.com/ec2/v2/home#Images:visibility=public-images;imageName=Sourcegraph-XS) | [size-S AMIs](https://console.aws.amazon.com/ec2/v2/home#Images:visibility=public-images;imageName=Sourcegraph-S) | [size-M AMIs](https://console.aws.amazon.com/ec2/v2/home#Images:visibility=public-images;imageName=Sourcegraph-M) | [size-L AMIs](https://console.aws.amazon.com/ec2/v2/home#Images:visibility=public-images;imageName=Sourcegraph-L) | [size-XL AMIs](https://console.aws.amazon.com/ec2/v2/home#Images:visibility=public-images;imageName=Sourcegraph-XL) |
21+
Refer to our [AWS Instance Sizing](/how-to/aws-instance-sizing) guide to determine the appropriate EC2 instance type for your Sourcegraph deployment based on the number of users and repositories.
3222

3323
Click [here](https://github.com/sourcegraph/deploy#amazon-ec2-amis) to see the completed list of AMI IDs published in each region.
3424

3525
**The default AMI username is `ec2-user`.**
3626

37-
<Callout type="note">While we recommend certain image types in our sizing chart, AMIs will dynamically use the resources available on the EC2 instance type they are deployed to, provided the minimum amount of resources needed is available. If you would like to resize your EC2 instance, follow the [upgrade steps](#upgrade) to switch to the correct AMI image that is optimized for your EC2 instance type.</Callout>
38-
3927
---
4028

4129
## Deploy Sourcegraph
4230

43-
1. In the [instance size chart](#instance-size-chart), click the link for the AMI that matches your deployment size.
31+
<img width="1256" alt="Screenshot 2025-05-06 at 3 52 51 PM" src="https://github.com/user-attachments/assets/10f34ced-843b-47f0-a9eb-c1ed41b37b69" />
32+
33+
1. Search for Sourcegraph in the AWS Marketplace or AMI catalog (see screenshot in the introduction).
4434
2. Choose **Launch instance from AMI**.
4535
3. Name your instance.
46-
4. Select an **instance type** according to [the sizing chart](#instance-size-chart) or your needs.
36+
4. Select an **instance type** according to [our sizing guide](/how-to/aws-instance-sizing) or your specific requirements.
4737
5. **Key pair (login)**: Select or create a new Key Pair for connecting to your instance securely (this may be required in the event you need support).
4838
6. **Network settings**:
4939
- Under "Auto-assign public IP" select "Enable".

‎docs/how-to/aws-instance-sizing.mdx‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
# AWS Instance Sizing for Sourcegraph
2+
3+
## Instance size chart
4+
5+
Select an instance type according to the number of users and repositories you have using this table. If you fall between two sizes, choose the larger of the two.
6+
7+
For example, if you have 8,000 users with 80,000 repositories, your instance size would be **L**. If you have 1,000 users with 80,000 repositories, you should still go with size **M**.
8+
9+
| | **XS** | **S** | **M** | **L** | **XL** |
10+
|----------------------|-----------------------|-----------------------|-----------------------|-----------------------|------------------------|
11+
| **Users** | ≥ 500 | ≥ 1,000 | ≥ 5,000 | ≥ 10,000 | ≥ 20,000 |
12+
| **Repositories** | ≥ 5,000 | ≥ 10,000 | ≥ 50,000 | ≥ 100,000 | ≥ 250,000 |
13+
| **Recommended Type** | m6a.2xlarge | m6a.4xlarge | m6a.8xlarge | m6a.12xlarge | m6a.24xlarge |
14+
| **Minimum Type** | m6a.2xlarge | m6a.2xlarge | m6a.4xlarge | m6a.8xlarge | m6a.12xlarge |
15+
16+
<Callout type="note">While we recommend certain instance types in our sizing chart, the Sourcegraph AMI will dynamically use the resources available on the EC2 instance type it is deployed to, provided the minimum amount of resources needed is available. If you would like to resize your EC2 instance, follow the [upgrade steps](/admin/deploy/machine-images/aws-ami#upgrade) to switch to a more appropriate instance type.</Callout>

0 commit comments

Comments
 (0)