Confirm user is happy to deploy free/paid cluster

Author: Westwooo

docs/commands/clusters.adoc

@@ -48,9 +48,11 @@ If used with no definition or flag values provided a free tier cluster with sens
 ```
 👤 Charlie 🏠 remote in ☁️ default._default._default
 > clusters create
-[INFO] 2025-07-04 11:35:41.392 provider not specified, defaulting to aws
-[INFO] 2025-07-04 11:35:41.392 cluster name not specified, a randomly generated name will be used
-[INFO] 2025-07-04 11:35:41.392 region not specified, defaulting to us-east-2
+[INFO] 2025-07-07 09:11:21.628 provider not specified, defaulting to aws
+[INFO] 2025-07-07 09:11:21.628 cluster name not specified, a randomly generated name will be used
+[INFO] 2025-07-07 09:11:21.628 region not specified, defaulting to us-east-2
+[WARN] 2025-07-07 09:11:21.628 this configuration will create a FREE cluster, is this okay? (y/n)
+y
 👤 Charlie 🏠 remote in ☁️ default._default._default
 > clusters
 ╭───┬────────────────────────┬──────────────────────────────────────┬───────────┬───────────────────────────╮
@@ -64,16 +66,26 @@ If used with no definition or flag values provided a free tier cluster with sens
 ╰───┴────────────────────────┴──────────────────────────────────────┴───────────┴───────────────────────────╯
 ```
 
-Free clusters clusters are limited in how they can be customised, and only the name, description, cloud provider, region and cidr can be configured.
+Before your cluster is created cbshell will tell you if the configuration will result in a free-tier or paid cluster, and as for confirmation: 
+
+```
+[WARN] 2025-07-07 09:11:21.628 this configuration will create a FREE cluster, is this okay? (y/n)
+y
+```
+
+Free clusters are limited in how they can be customised, and only the name, description, cloud provider, region and cidr can be configured.
 Check the https://docs.couchbase.com/cloud/management-api-reference/index.html#tag/Free-Tier[Capella API docs] for more information.
 You can configure all of these fields with the relevant flags: 
 
 ```
 👤 Charlie 🏠 remote in ☁️ default._default._default
 > clusters create --name free-gcp --description "My first couchbase cluster" --cidr 10.0.0.0/24 --provider gcp --region us-central1
+[WARN] 2025-07-07 09:13:32.545 this configuration will create a FREE cluster, is this okay? (y/n)
+y
 ``` 
 
-Getting the cluster details shows that this has still deployed a free tier cluster: 
+We can see from the warning that we will still deploy a free tier cluster.
+This can be double checked by getting the full details of the cluster being deployed: 
 
 ```
 > clusters get free-gcp
@@ -121,6 +133,7 @@ For example the following will create a paid cluster because the number of nodes
 
 ```
 > clusters create --name paid-azure --description "My first couchbase cluster" --cidr 10.0.2.0/24 --provider azure --region eastus --nodes 3
+[WARN] 2025-07-07 09:15:36.022 this configuration will create a PAID cluster, is this okay? (y/n)
 👤 Charlie 🏠 remote in ☁️ default._default._default
 > clusters get paid-azure
 ╭────────────────────┬───────────────────────────────────────────────────────────────────────────────╮
@@ -164,8 +177,17 @@ For example the following will create a paid cluster because the number of nodes
 ╰────────────────────┴───────────────────────────────────────────────────────────────────────────────╯
 ```
 
-The created cluster can be configured using flags:
+If you need to skip this confirmation step then the `--confirm` or `-c` flag for short can be used: 
+
+```
+👤 Charlie 🏠 remote in ☁️ default._default._default
+> clusters create --name paid-azure --description "My first couchbase cluster" --cidr 10.0.2.0/24 --provider azure --region eastus --nodes 3 -c
+👤 Charlie 🏠 remote in ☁️ default._default._default
+```
+
+The full set of flags for `clusters create` is:
 ```
+  -h, --help: Display the help message for this command
   --name <string>: the name of the cluster
   --provider <string>: the cloud provider
   --version <string>: the couchbase server version
@@ -175,6 +197,7 @@ The created cluster can be configured using flags:
   --description <string>: description for the cluster
   --region <string>: cloud provider region for the cluster
   --cidr <string>: cider block for the cluster
+  -c, --confirm: skip confirmation of the cluster creation
 ```
 
 If you want complete control over the structure of the cluster then you can pipe a JSON cluster definition into the command:

src/cli/clusters_create.rs

@@ -1,12 +1,13 @@
 use crate::client::cloud_json::{ClusterCreateRequest, FreeTierClusterCreateRequest, Provider};
 use crate::state::State;
-use log::{debug, info};
+use log::{debug, info, warn};
 use std::convert::TryFrom;
 use std::sync::{Arc, Mutex};
 
 use crate::cli::error::{client_error_to_shell_error, serialize_error};
 use crate::cli::generic_error;
 use crate::cli::util::{find_org_id, find_project_id};
+use crate::read_input;
 use nu_engine::command_prelude::Call;
 use nu_engine::CallExt;
 use nu_protocol::engine::{Command, EngineState, Stack};
@@ -75,6 +76,11 @@ impl Command for ClustersCreate {
                 "cider block for the cluster",
                 None,
             )
+            .switch(
+                "confirm",
+                "skip confirmation of the cluster creation",
+                Some('c'),
+            )
             .category(Category::Custom("couchbase".to_string()))
     }
 
@@ -187,10 +193,23 @@ fn clusters_create(
         }
     };
 
-    let capella = call.get_flag(engine_state, stack, "capella")?;
+    if !call.has_flag(engine_state, stack, "confirm")? {
+        if free_tier {
+            warn!("this configuration will create a FREE cluster, is this okay? (y/n)")
+        } else {
+            warn!("this configuration will create a PAID cluster, is this okay? (y/n)")
+        }
+
+        let confirmation = read_input().unwrap_or("y".to_string());
+        if confirmation != "y" {
+            info!("cluster creation canceled");
+            return Ok(PipelineData::empty());
+        }
+    }
 
     debug!("Running clusters create for {:?}", definition);
 
+    let capella: Option<String> = call.get_flag(engine_state, stack, "capella")?;
     let guard = state.lock().unwrap();
     let control = guard.named_or_active_org(capella)?;
     let client = control.client();

src/main.rs

@@ -487,7 +487,7 @@ fn maybe_write_config_file(opt: CliOptions, password: Option<String>) -> PathBuf
     path
 }
 
-fn read_input() -> Option<String> {
+pub fn read_input() -> Option<String> {
     let mut answer = String::new();
     std::io::stdin()
         .read_line(&mut answer)