Manage host clusters

Updated at:

A host cluster can contain Alibaba Cloud ECS instances, hosts from other cloud providers, and on-premises hosts. To use Alibaba Cloud ECS instances, you only need to authorize Alibaba Cloud DevOps through a service link. For hosts from other providers or your own data center, ensure they have access to the public network and install the agent on them. The agent connects the hosts to AppStack and makes them available for use.

Import a host cluster

  • Go to the AppStack resource pool and click Import Host Cluster to open the import dialog.

    • Step 1: Copy the agent installation command and run it on the hosts you want to add. The process typically takes 1 to 2 minutes.

    • Step 2: After the command runs successfully, click Refresh in the List of Addable Hosts section to see the newly available hosts.

    • Step 3: Select the checkboxes for the hosts you want to add.

    • Step 4: Enter a name and a display name for the host cluster. The name must be unique and cannot be changed after creation. Click OK to import the selected hosts into the AppStack resource pool as a host cluster.

The host cluster name can contain 1 to 63 lowercase letters, digits, or hyphens (-). The host cluster display name can contain 1 to 32 Chinese characters, letters, digits, or symbols.

Host cluster details

After a host cluster is imported successfully, you are automatically redirected to its details page. You can also navigate to the resource pool > host cluster list in AppStack, find your host cluster, and click it to open the details page. This page displays basic information, the host list, associated deployment groups, and deployment information. From here, you can modify the host cluster, add hosts, manage deployment groups, and manage members.

Basic information

Displays information such as the host cluster name, resource type, and the number of hosts.

Deployment information

  • Deployed applications: The total number of applications that use resources from this host cluster.

  • Deployed environments: The total number of deployment environments that use resources from this host cluster.

Host list

  • Displays a list of hosts in the current host cluster.

    • host ID: The unique ID that the system generates for the host.

    • IP: The IP address of the host.

    • hostname: The hostname of the host.

    • Connection status: The connectivity status of the host agent.

    • Allocation status: Indicates whether the host is assigned to a deployment group.

Add hosts

  • If the host cluster runs low on resources, you can add more hosts to it. To do this, go to the host cluster details page > Add Host.

    • Copy the agent installation command and run it on the hosts you want to add. The process typically takes 1 to 2 minutes.

    • After the command runs successfully, refresh the List of Addable Hosts, select the hosts you want to add, and click OK to import them into the cluster.

Remove hosts

When a host is taken offline or its resources need to be reallocated, you can remove it from the host cluster. To do this, on the host cluster details page, go to the Host List and click Remove Host. Removing a host only unlinks it from the current host cluster. It does not delete the underlying host resource.

Associated deployment groups

  • A deployment group is a logical division of physical resources and serves as the smallest unit for deploying and maintaining an application environment. To deploy an application, you must associate the application environment with a deployment group. The Associated Deployment Groups list shows the deployment groups related to this host cluster.

    • Deployment group display name

    • Deployment group name

    • Associated hosts: The number of associated hosts. Click the number to view a detailed list of the hosts, including their host ID, hostname, and IP address.

    • Usage status: Indicates whether the deployment group is being used by an application environment. If not, the status is Idle. If it is in use, the associated environment is displayed.

    • Creator

Create a deployment group

  • A resource administrator can create new deployment groups and assign them to different application environments. To do this, go to the host cluster details page > Associated Deployment Groups > New Deployment Group.

    • Enter a deployment group name, which serves as a unique identifier, and a deployment group display name.

    • Select the hosts to assign to the group and click OK to create the deployment group.

Delete a deployment group

When an application environment is no longer needed and you have deleted it, you can delete its associated deployment group. This action releases the hosts back to the host cluster, making them available for other environments. To do this, go to the host cluster details page > Associated Deployment Groups list, click Delete, and confirm the action. Note: Deleting a deployment group only releases the hosts back to their original host cluster. It does not affect any services running on the hosts or delete the hosts themselves.

Modify a deployment group

You can modify the display name of a deployment group and add or remove its associated hosts.

Member management

  • Host clusters feature role-based access control. Two roles are available for a host cluster:

    • Administrator: Has full permissions to use, edit, and delete the cluster. An administrator can modify basic cluster information, add or remove hosts, create or modify deployment groups, associate deployment groups with application environments, and delete the cluster.

    • User: Has usage permissions. When associating an application environment, a user can select deployment groups from clusters where they have at least user permissions.

Modify a host cluster

You can modify the display name of a host cluster. To do this, go to the host cluster details page > Modify Host Cluster.

Delete a host cluster

When a host cluster is no longer needed, you can delete it. To do this, go to the host cluster details page > More Actions > Delete Cluster. Note: Deleting a cluster only unbinds the hosts from the AppStack > resource pool and deletes the host cluster metadata. It does not affect any services running on the hosts or delete the hosts themselves.

Use a host cluster for deployments

For more information, see Create an environment.