new: Add support for VM Placement

[lgarber-akamai]

📝 Description

This pull request adds support for the upcoming Placement Groups feature, including the following changes:

• New Endpoints:

  • POST placement/groups
  • GET placement/groups
  • GET placement/groups/{pg_id}
  • PUT placement/groups/{pg_id}
  • POST placement/groups/{pg_id}/assign
  • POST placement/groups/{pg_id}/unassign
  • DELETE placement/groups/{pg_id}

• Updated Endpoints:

  • GET /linode/instances & /linode/instances/{linode_id} - Updated to include PG info
  • POST /linode/instances - Updated to accept a PG to assign the Linode to on creation
  • POST /linode/instances/{linode_id}/migrate - Updated to accept a PG to assign the Linode to on creation
  • POST /linode/instances/{linode_id}/clone - Updated to accept a PG to assign the Linode to on creation
  • GET /regions & /regions/{region_id} - Updated to include PG limits

This pull request also contains the corresponding integration tests and fixtures for these changes.

✔️ How to Test

The following test steps assume you have pulled down this PR locally and have pointed your LINODE_URL and LINODE_TOKEN environment variables accordingly.

Integration Testing

make ARGS="-run TestInstance" fixtures
make ARGS="-run TestPlacementGroup" fixtures
make ARGS="-run TestRegion" fixtures

Manual Testing

1. In a linodego sandbox environment, run the following:

package main

import (
	"context"
	"fmt"
	"log"
	"os"

	"github.com/linode/linodego"
)

const targetRegion = "eu-west"

func main() {
	ctx := context.Background()

	client := linodego.NewClient(nil)
	client.SetToken(os.Getenv("LINODE_TOKEN"))

	// Create a PG
	pg, err := client.CreatePlacementGroup(ctx, linodego.PlacementGroupCreateOptions{
		Label:        "test-pg",
		Region:       targetRegion,
		AffinityType: linodego.AffinityTypeAntiAffinityLocal,
		IsStrict:     true,
	})
	if err != nil {
		log.Fatal(err)
	}

	// Provision two instances assigned to the PG
	compliantOnly := true

	for i := 0; i < 2; i++ {
		_, err := client.CreateInstance(ctx, linodego.InstanceCreateOptions{
			Region: targetRegion,
			Type:   "g6-nanode-1",
			Label:  fmt.Sprintf("test-instance-%d", i),
			PlacementGroup: &linodego.InstanceCreatePlacementGroupOptions{
				ID:            pg.ID,
				CompliantOnly: &compliantOnly,
			},
		})
		if err != nil {
			log.Fatal(err)
		}
	}
}

2. Navigate to Cloud Manager and ensure a new Placement Group has been created with two instances assigned to it.
3. Modify this code with update logic, assignment logic, etc.
4. Re-run the file and ensure everything works as expected.

[lgarber-akamai]

This was added in the parent/child project branch (which hasn't been merged to main yet)

[yec-akamai]

Nice work! All tests passed on my end 🎉

[ykim-akamai]

Looks good, tests pass locally