new: Add module to manage placement group assignment

[yec-akamai]

📝 Description

Add a new module placement_group_assign to manage the 1:1 assignment between a Linode and a placement group.

✔️ How to Test

Run pip install --force -r requirements.txt to install required dependencies.

Also, you need to set up environment variables to test against alpha:

export TEST_API_CA=$PWD/cacert.pem
export TEST_API_URL=https://.../
export LINODE_TOKEN=...

make TEST_ARGS="-v placement_group_assign" test

Manual test:

1. In a sandbox environment, i.e. dx-dvenv, run the following ansible playbook

- name: ansible_linode Sandbox Playbook
  hosts: localhost
  tasks:
    - name: Create a Linode placement group
      linode.cloud.placement_group:
        label: my-ansible-test-pg
        region: us-east
        affinity_type: anti_affinity:local
        state: present
      register: pg_created

    - name: Create a Linode instance
      linode.cloud.instance:
        label: test-pg-instance
        type: g6-nanode-1
        region: us-east
        state: present
      register: instance

    - name: Assign Linode to the placement group
      linode.cloud.placement_group_assign:
        placement_group_id: '{{ pg_created.placement_group.id }}'
        linode_id: '{{ instance.instance.id }}'
        state: present
      register: pg_assign

    - name: Get placement group info
      linode.cloud.placement_group_info:
        id: '{{ pg_created.placement_group.id }}'
      register: pg_assign_info

2. Observe that the Linode is successfully assigned to the placement group. And it appears in the members of the placement group info.

3. Run the following playbook to unassign from the placement group

    - name: Unassign Linode to the placement group
      linode.cloud.placement_group_assign:
        placement_group_id: '{{ pg_created.placement_group.id }}'
        linode_id: '{{ instance.instance.id }}'
        state: absent
      register: pg_unassign

    - name: Get placement group info
      linode.cloud.placement_group_info:
        id: '{{ pg_created.placement_group.id }}'
      register: pg_unassign_info

4. Observe that the Linode is removed from the placement group members.

[zliang-akamai]

Works well locally. Nice job!

[jriddle-linode]

LGTM!