The playbooks in this directory provide a simple way to control the deployment of an AIStore cluster and its related resources.
Each playbook is documented separately. For a full walkthrough of deployment, see the deployment guide.
| Playbook(s) | Description |
|---|---|
| ais_cleanup_all | Clean up all metadata AND data from the cluster. |
| ais_cleanup_markers | Clean up metadata and markers on targets. |
| ais_deploy_cluster | Deploy an AIS cluster. See ais_cluster_management docs. |
| ais_deploy_operator | Deploy the operator which enables cluster dpeloyment. See ais_cluster_management docs. |
| ais_shutdown_cluster | Gracefully shuts down an AIS cluster, preserving metadata and configuration for future restarts. |
| ais_decommission_cluster | Cleans up the AIS cluster's resources, including cluster maps, configuration files, PVCs, PVs, and node labels. Ensures a complete removal of the AIS cluster from the K8s env. |
| ais_restart_cluster | Decommissions the AIStore cluster by deleting the CRD. If delete_conf is set to true, it also cleans up the configuration from all nodes. Afterward, the AIStore cluster is redeployed with the new configuration, while ensuring that user data is preserved. Used for switching between http/https clusters or adding AuthN config after initial deployment. See switch_protocol docs. |
| ais_undeploy_operator | Remove the operator from the K8s cluster. |
| create_network_definition | Create network definitions for multihome deployments. See multihome docs. |
| fetch_ca_cert | Fetch the CA cert secret for a client to use self-signed certificate verification. See ais_https_configuration docs |
| generate_https_cert | Generate HTTPS certificates for the cluster. See generate_https_cert docs. |
| install_requirements.yml | Install required ansible collections locally and Python requirements on the K8s controller host. |
| ais_downscale_cluster | Decrease the number of nodes (proxy and target) in your current AIS Cluster. See scaling docs. |
| ais_deploy_authn | Deploy the AIStore Authentication (AuthN) server. |
| ais_undeploy_authn | Undeploy the AIStore Authentication (AuthN) server. |
| ais_replace_node | Automates replacing a K8s node hosting ais-target and ais-proxy pods in the AIS (AIStore) cluster. It is used to move these workloads to another node, typically for maintenance or decommissioning. WARNING: Destructive, if not properly managed. |