Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix to modified date and concept clarification #7018

Merged
merged 3 commits into from
Jul 8, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/products/compute/compute-instances/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,13 @@
title: Compute Instances
title_meta: "Compute Instance Product Documentation"
description: "Host your workloads on Linode's secure and reliable cloud infrastructure using Compute Instances, versatile Linux-based virtual machines."
published: 2023-01-18
modified: 2024-05-21
tab_group_main:
is_root: true
title: Overview
weight: 10
cascade:
date: 2023-01-18
product_description: "Linux virtual machines equipped with a tailored set of resources designed to run any cloud-based workload."
---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
title: Developers
title_meta: "Developer Resources for Compute Instances"
description: "Easily manage Compute Instances with developer tools like the Linode API or CLI as well as third party tools and integrations."
published: 2023-01-18
tab_group_main:
weight: 50
aliases: ['/products/compute/shared-linodes/developers/','/products/compute/shared-cpu/developers/','/products/compute/gpu/developers/','/products/compute/dedicated-cpu/developers/','/products/compute/high-memory/developers/']
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
title: Get Started
title_meta: "Getting Started with Compute Instances"
description: "Learn how to quickly start using Compute Instances on the Linode Platform."
published: 2023-01-18
tab_group_main:
weight: 20
aliases: ['/products/compute/shared-linodes/get-started/','/products/compute/shared-cpu/get-started/','/products/compute/dedicated-cpu/get-started/','/products/compute/gpu/get-started/','/products/compute/high-memory/get-started/']
Expand Down
1 change: 1 addition & 0 deletions docs/products/compute/compute-instances/guides/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
title: Guides
title_meta: "Guides and Tutorials for Compute Instances"
description: "A collection of guides to help you start deploying Compute Instances and using them to host your web applications and Cloud workloads"
published: 2023-01-18
modified: 2024-06-20
tab_group_main:
weight: 30
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,20 @@
title: "Work with Placement Groups"
description: "Learn how to group your compute instances to best meet your delivery model."
published: 2024-06-20
modified: 2024-06-26
keywords: ["placement-group", "affinity", "compliance"]
---

When you deploy several compute instances in an Akamai data center ("region"), they're allocated to physical machines. This allocation varies based on several factors, including the compute instance plan and availability for that plan sizes. However, you may want your compute instances in specific physical locations, to best support your need. You may want them close together, even on the same host to speed up performance. Or, you may want to disperse them across several hosts to support high availability. Placement groups let you determine this physical location to meet either of these models.
When you deploy several compute instances in an Akamai data center ("region"), they're allocated to physical machines. This allocation varies based on several factors, including the compute instance plan and availability for that plan's sizes. However, you may want your compute instances in specific physical locations, to best support your need:

- You may want them close together, even on the same host to speed up performance.
- You may want to disperse them across several hosts to support high availability.

Placement groups let you determine this physical location to meet either of these models.

## Overview

The Placement Groups service gives you a convenient way to set up groups of your compute instances, using Cloud Manager, API operations, or our CLI. Create a new placement group in a supported region and add new or existing compute instances from that region to your group. With the new group created, we physically move your compute instances into it, based on your desired model.
The Placement Groups service gives you a convenient way to set up groups of your compute instances, using our various tools. Create a new placement group in a supported region and add new or existing compute instances from that region to your group. With the new group created, we physically move your compute instances into it, based on your desired model.

## Availability

Expand All @@ -25,23 +31,27 @@ Placement Groups is in limited availability. Throughout this phase, we expect to

## Affinity, enforcement, and compliance

To distribute your compute instances in a placement group, we use the industry-recognized affinity standard. Pick from one of two types to serve as your "preferred container" type for your placement group:
To distribute your compute instances in a placement group, we use the industry-recognized affinity standard. This standard supports two "preferred container" types:

- **Affinity**. Compute instances are physically close together, possibly on the same host. This preferred container type is best for applications that require performance over availability.

- **Affinity**. Your compute instances are physically close together, possibly on the same host. Set this as your preferred container if your application requirements value performance over availability.
- **Anti-affinity**. Compute instances are placed in separate fault domains, but they're still in the same region. This preferred container type better supports a high-availability model.

- **Anti-affinity**. Your compute instances are placed in separate fault domains, but they're still in the same region. Use this preferred container to better support a high-availability model.
{{< note >}}
During the limited availability phase, only the **Anti-affinity** preferred container type is supported.
{{< /note >}}

In addition to selecting the Affinity Type, you select how it's enforced when you add more Compute Instances to the placement group.
Placement groups also enforce the use of the preferred container type using one of two methods:

- **Strict (Best practice)**. You can't add more compute instances to your placement group if your preferred container lacks capacity or is unavailable. For example, let's assume you've set **Anti-affinity** as your affinity type. If you try to add a compute instance that's on the same host, or there's no capacity outside that host in the region, you get an error and can't add the compute instance. This helps you keep your placement group compliant, because you can only pick compute instances that fit your desired model.
- **Strict (Best practice)**. You can't add more compute instances to your placement group if the preferred container lacks capacity or is unavailable. For example, let's assume the preferred container type is **Anti-affinity**. If you try to add a compute instance that's on the same host, or there's no capacity outside that host in the region, you get an error and can't add the compute instance. This helps you keep your placement group compliant, because you can only pick compute instances that fit the preferred container type.

- **Flexible**. You can add more compute instances to your placement group even if they're outside your affinity type's preferred container. However, if you add one and it violates your affinity type, the placement group becomes non-compliant. Once the necessary capacity is available in the data center, we physically move the compute instance for you to fit your affinity type's preferred container and make it compliant again. This can work for you if you know you need to add more compute instances to your group in the future.
- **Flexible**. You can add more compute instances to your placement group even if they're outside the preferred container type. However, if you add one and it violates the preferred container type, the placement group becomes non-compliant. Once the necessary capacity is available in the region, we physically move the compute instance for you to fit your preferred container type and make it compliant again. This can work for you if you know you need to add more compute instances in the future.

### Fix Non-compliance

If a placement group becomes non-compliant, we're alerted and we'll bring it back into compliance as soon as possible. Non-compliance can only be fixed by Akamai staff. **_You can't fix it yourself_**.

By design, a Strict placement group can't be made non-compliant when simply creating it or managing its Compute Instances. In rare cases, non-compliance can occur if we need to fail-over or migrate your Compute Instances for maintenance. Because of this, fixing non-compliance for Strict placement groups is prioritized over Flexible groups.
By design, a Strict placement group can't be made non-compliant when simply creating it or managing its compute instances. In rare cases, non-compliance can occur if we need to fail-over or migrate your compute instances for maintenance. Fixing non-compliance for Strict placement groups is prioritized over Flexible groups.

## Create a placement group

Expand All @@ -66,7 +76,7 @@ Make sure you understand how placement groups work. Have a look at [Affinity, en

{{< note >}}
- During the limited availability phase, only **Anti-affinity** is available for Affinity Type.
- Once you create your placement group, you *can't change its Affinity Type Enforcement*.
- Once you create your placement group, you *can't change* its Affinity Type Enforcement.
{{< /note >}}

3. When you're ready, click **Create Placement Group**. A summary of your group is revealed.
Expand Down
1 change: 1 addition & 0 deletions docs/products/compute/compute-instances/resources/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
title: Resources
title_meta: "Resources for Compute Instances"
description: "Resources and other information related to Compute Instances, including videos, blog posts, community posts, customer stories, and press releases."
published: 2023-01-18
tab_group_main:
weight: 40
aliases: ['/products/compute/shared-linodes/resources/','/products/compute/shared-cpu/resources/','/products/compute/gpu/resources/','/products/compute/dedicated-cpu/resources/']
Expand Down
Loading