anyscale 0.26.67__py3-none-any.whl → 0.26.69__py3-none-any.whl

anyscale/commands/cloud_commands.py

@@ -137,14 +137,11 @@ def default_region(provider: str) -> str:
     show_default=True,
 )
 @click.option(
-    "--cluster-name",
-    help="Kubernetes cluster name (required for k8s stack).",
-    required=False,
-    type=str,
+    "--cluster-name", help="Kubernetes cluster name. (K8s)", required=False, type=str,
 )
 @click.option(
     "--namespace",
-    help="Kubernetes namespace for Anyscale operator (for k8s stack).",
+    help="Kubernetes namespace for Anyscale operator. (K8s)",
     required=False,
     type=str,
     default="anyscale-operator",
@@ -166,13 +163,13 @@ def default_region(provider: str) -> str:
     "--anyscale-managed",
     is_flag=True,
     default=False,
-    help="Let anyscale create all the resources.",
+    help="Let anyscale create all the resources. (VM)",
 )
 @click.option(
     "--enable-head-node-fault-tolerance",
     is_flag=True,
     default=False,
-    help="Whether to enable head node fault tolerance for services.",
+    help="Whether to enable head node fault tolerance for services. (VM)",
 )
 @click.option(
     "--yes", "-y", is_flag=True, default=False, help="Skip asking for confirmation."
@@ -193,17 +190,24 @@ def default_region(provider: str) -> str:
     type=click.Choice([e.value for e in SharedStorageType], case_sensitive=False),
     default=SharedStorageType.OBJECT_STORAGE.value,
     show_default=True,
-    help="The type of shared storage to use for the cloud. Use 'object-storage' for cloud bucket-based storage (e.g., S3, GCS), or 'nfs' for network file systems.",
+    help="The type of shared storage to use for the cloud. Use 'object-storage' for cloud bucket-based storage (e.g., S3, GCS), or 'nfs' for network file systems. (VM)",
 )
 @click.option(
     "--values-file",
-    help="Path to save the generated Helm values file (for k8s stack, default: auto-generated with timestamp).",
+    help="Path to save the generated Helm values file (for k8s stack, default: auto-generated with timestamp). (K8s)",
     required=False,
     type=str,
 )
 @click.option(
     "--debug", is_flag=True, default=False, help="Enable debug logging.",
 )
+@click.option(
+    "--operator-chart",
+    help="Path to operator chart (skips helm repo add/update). (K8s)",
+    required=False,
+    type=str,
+    hidden=True,
+)
 def setup_cloud(  # noqa: PLR0913
     provider: str,
     region: str,
@@ -220,6 +224,7 @@ def setup_cloud(  # noqa: PLR0913
     shared_storage: str,
     values_file: Optional[str],
     debug: bool,
+    operator_chart: Optional[str],
 ) -> None:
     # TODO (congding): remove `anyscale_managed` in the future, now keeping it for compatibility
 
@@ -241,6 +246,7 @@ def setup_cloud(  # noqa: PLR0913
             yes=yes,
             values_file=values_file,
             debug=debug,
+            operator_chart=operator_chart,
         )
         return
 

anyscale/commands/command_examples.py

@@ -538,6 +538,59 @@ $ anyscale project get-default --cloud my-cloud-id --json
 """
 
 
+CLOUD_SETUP_K8S_AWS_EXAMPLE = """\
+# Set up a Kubernetes cloud on AWS EKS
+$ anyscale cloud setup --provider aws --region us-west-2 --name my-k8s-cloud \\
+    --stack k8s --cluster-name my-eks-cluster --namespace anyscale-operator \\
+    --debug --yes
+Output
+(anyscale +1.0s) Setting up Kubernetes cloud 'my-k8s-cloud' on AWS
+(anyscale +1.5s) Required CLI tools are installed (kubectl, helm, aws)
+(anyscale +2.3s) Using namespace: anyscale-operator
+(anyscale +5.2s) Cluster discovered: arn:aws:eks:us-west-2:123456789012:cluster/my-eks-cluster
+(anyscale +8.4s) Setting up AWS infrastructure...
+(anyscale +1m12.3s) CloudFormation stack created
+(anyscale +1m15.7s) Cloud registered with ID: cld_abc123
+(anyscale +1m18.2s) Adding Anyscale Helm repository...
+(anyscale +1m20.5s) Installing Anyscale operator...
+(anyscale +1m25.8s) Generated Helm values file: anyscale-helm-values-aws-anyscale-operator-20241015_175602.yaml
+(anyscale +2m45.3s) Helm installation completed successfully
+(anyscale +2m45.4s) Kubernetes cloud 'my-k8s-cloud' setup completed successfully!
+"""
+
+CLOUD_SETUP_K8S_GCP_EXAMPLE = """\
+# Set up a Kubernetes cloud on GCP GKE
+$ anyscale cloud setup --provider gcp --region us-central1 --name my-gke-cloud \\
+    --stack k8s --cluster-name my-gke-cluster --namespace anyscale-operator \\
+    --project-id my-project-123 --yes
+Output
+(anyscale +1.0s) Setting up Kubernetes cloud 'my-gke-cloud' on GCP
+(anyscale +1.5s) Required CLI tools are installed (kubectl, helm, gcloud, gsutil)
+(anyscale +2.3s) Using namespace: anyscale-operator
+(anyscale +5.8s) Cluster discovered: gke_my-project-123_us-central1_my-gke-cluster
+(anyscale +9.2s) Setting up GCP infrastructure...
+(anyscale +15.4s) Created GCS bucket: anyscale-k8s-my-gke-cloud-a1b2c3d4
+(anyscale +18.7s) Created service account: anyscale-operator-e5f6g7h8@my-project-123.iam.gserviceaccount.com
+(anyscale +25.3s) GCP resources created successfully
+(anyscale +28.1s) Cloud registered with ID: cld_xyz789
+(anyscale +30.5s) Installing Anyscale operator...
+(anyscale +35.8s) Generated Helm values file: anyscale-helm-values-gcp-anyscale-operator-20241015_180215.yaml
+(anyscale +1m55.2s) Helm installation completed successfully
+(anyscale +1m55.3s) Kubernetes cloud 'my-gke-cloud' setup completed successfully!
+"""
+
+CLOUD_SETUP_K8S_CUSTOM_VALUES_EXAMPLE = """\
+# Set up a Kubernetes cloud with a custom Helm values file path
+$ anyscale cloud setup --provider aws --region us-west-2 --name my-k8s-cloud \\
+    --stack k8s --cluster-name my-eks-cluster \\
+    --values-file /path/to/custom-values.yaml --yes
+Output
+(anyscale +1.0s) Setting up Kubernetes cloud 'my-k8s-cloud' on AWS
+...
+(anyscale +1m25.8s) Generated Helm values file: /path/to/custom-values.yaml
+...
+"""
+
 CLOUD_ADD_COLLABORATORS_EXAMPLE = """\
 $ anyscale cloud add-collaborators --cloud cloud_name --users-file collaborators.yaml
 (anyscale +1.3s) Successfully added 2 collaborators to cloud cloud_name.