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

anyscale/service/commands.py

@@ -1,4 +1,4 @@
-from typing import List, Optional, Union
+from typing import Dict, List, Optional, Union
 
 from anyscale._private.models.model_base import ResultIterator
 from anyscale._private.sdk import sdk_command
@@ -32,10 +32,14 @@ anyscale.service.deploy(
 """
 
 _DEPLOY_ARG_DOCSTRINGS = {
-    "config": "The config options defining the service.",
+    "configs": "The config options defining the service.",
     "in_place": "Perform an in-place upgrade without starting a new cluster. This can be used for faster iteration during development but is *not* currently recommended for production deploys. This *cannot* be used to change cluster-level options such as image and compute config (they will be ignored).",
     "canary_percent": "The percentage of traffic to send to the canary version of the service (0-100). This can be used to manually shift traffic toward (or away from) the canary version. If not provided, traffic will be shifted incrementally toward the canary version until it reaches 100. Not supported when using --in-place. This is ignored when restarting a service or creating a new service.",
     "max_surge_percent": "Amount of excess capacity allowed to be used while updating the service (0-100). Defaults to 100. Not supported when using --in-place.",
+    "versions": "Enable multi-version deployment by providing a JSON array of objects or a JSON object in text format. Defines the version name, traffic and capacity percents per version. Capacity defaults to traffic.",
+    "name": "Name of the service. When running in a workspace, this defaults to the workspace name.",
+    "cloud": "The Anyscale Cloud of this workload. If not provided, the organization default will be used (or, if running in a workspace, the cloud of the workspace).",
+    "project": "Named project to use for the service. If not provided, the default project for the cloud will be used (or, if running in a workspace, the project of the workspace).",
 }
 
 
@@ -46,11 +50,15 @@ _DEPLOY_ARG_DOCSTRINGS = {
     arg_docstrings=_DEPLOY_ARG_DOCSTRINGS,
 )
 def deploy(
-    config: ServiceConfig,
+    configs: Union[ServiceConfig, List[ServiceConfig]],
     *,
     in_place: bool = False,
     canary_percent: Optional[int] = None,
     max_surge_percent: Optional[int] = None,
+    versions: Optional[str] = None,
+    name: Optional[str] = None,
+    cloud: Optional[str] = None,
+    project: Optional[str] = None,
     _private_sdk: Optional[PrivateServiceSDK] = None,
 ) -> str:
     """Deploy a service.
@@ -62,10 +70,14 @@ def deploy(
     Returns the id of the deployed service.
     """
     return _private_sdk.deploy(  # type: ignore
-        config,
+        configs=configs,
         in_place=in_place,
         canary_percent=canary_percent,
         max_surge_percent=max_surge_percent,
+        versions=versions,
+        name=name,
+        cloud=cloud,
+        project=project,
     )
 
 
@@ -311,6 +323,77 @@ _CONTROLLER_LOGS_ARG_DOCSTRINGS = {
     "max_lines": "The number of log lines to be fetched. If not provided, 1000 lines will be fetched.",
 }
 
+# SDK docs for Service tag operations
+_TAGS_ADD_EXAMPLE = """
+import anyscale
+
+anyscale.service.add_tags(id="svc_123", tags={"team": "mlops", "env": "prod"})
+"""
+
+_TAGS_ADD_ARG_DOCSTRINGS = {
+    "id": "ID of the service. Provide either id or name.",
+    "name": "Name of the service. Provide either id or name.",
+    "cloud": "Cloud name (used when resolving by name).",
+    "project": "Project name (used when resolving by name).",
+    "tags": "Key/value tags to upsert as a map {key: value}.",
+}
+
+_TAGS_REMOVE_EXAMPLE = """
+import anyscale
+
+anyscale.service.remove_tags(id="svc_123", keys=["team", "env"])
+"""
+
+_TAGS_REMOVE_ARG_DOCSTRINGS = {
+    "id": "ID of the service. Provide either id or name.",
+    "name": "Name of the service. Provide either id or name.",
+    "cloud": "Cloud name (used when resolving by name).",
+    "project": "Project name (used when resolving by name).",
+    "keys": "List of tag keys to remove.",
+}
+
+
+@sdk_command(
+    _SERVICE_SDK_SINGLETON_KEY,
+    PrivateServiceSDK,
+    doc_py_example=_TAGS_ADD_EXAMPLE,
+    arg_docstrings=_TAGS_ADD_ARG_DOCSTRINGS,
+)
+def add_tags(
+    *,
+    id: Optional[str] = None,  # noqa: A002
+    name: Optional[str] = None,
+    cloud: Optional[str] = None,
+    project: Optional[str] = None,
+    tags: Dict[str, str],
+    _private_sdk: Optional[PrivateServiceSDK] = None,
+) -> None:
+    """Upsert (add/update) tag key/value pairs for a service."""
+    return _private_sdk.add_tags(  # type: ignore
+        id=id, name=name, cloud=cloud, project=project, tags=tags
+    )
+
+
+@sdk_command(
+    _SERVICE_SDK_SINGLETON_KEY,
+    PrivateServiceSDK,
+    doc_py_example=_TAGS_REMOVE_EXAMPLE,
+    arg_docstrings=_TAGS_REMOVE_ARG_DOCSTRINGS,
+)
+def remove_tags(
+    *,
+    id: Optional[str] = None,  # noqa: A002
+    name: Optional[str] = None,
+    cloud: Optional[str] = None,
+    project: Optional[str] = None,
+    keys: List[str],
+    _private_sdk: Optional[PrivateServiceSDK] = None,
+) -> None:
+    """Remove tags by key from a service."""
+    return _private_sdk.remove_tags(  # type: ignore
+        id=id, name=name, cloud=cloud, project=project, keys=keys
+    )
+
 
 # This is a private command that is not exposed to the user.
 @sdk_command(
@@ -363,6 +446,7 @@ _LIST_ARG_DOCSTRINGS = {
     "cloud": "Name of the Anyscale Cloud to search in.",
     "project": "Name of the Anyscale Project to search in.",
     "include_archived": "Include archived services (default: False).",
+    "tags_filter": "Filter services by tags as a dict: {key: [values...]}. Values with the same key are ORed; keys are ANDed.",
     # Paging
     "max_items": "Maximum **total** number of items to yield (default: iterate all).",
     "page_size": "Number of items to fetch per API request (default: API default).",
@@ -390,6 +474,7 @@ def list(  # noqa: A001
     cloud: Optional[str] = None,
     project: Optional[str] = None,
     include_archived: bool = False,
+    tags_filter: Optional[Dict[str, List[str]]] = None,
     # Paging
     max_items: Optional[int] = None,
     page_size: Optional[int] = None,
@@ -408,6 +493,7 @@ def list(  # noqa: A001
         cloud=cloud,
         project=project,
         include_archived=include_archived,
+        tags_filter=tags_filter,
         max_items=max_items,
         page_size=page_size,
         sort_field=sort_field,

anyscale/service/models.py

@@ -213,6 +213,9 @@ tracing_config: # (Optional) Configuration options for tracing.
   enabled: true
   exporter_import_path: my_module:custom_tracing_exporter
   sampling_ratio: 1.0
+tags:
+  team: serving
+  cost-center: eng
 """
 
     # Override the `name` field from `WorkloadConfig` so we can document it separately for jobs and services.
@@ -231,6 +234,16 @@ tracing_config: # (Optional) Configuration options for tracing.
         },
     )
 
+    version_name: Optional[str] = field(
+        default=None, metadata={"docstring": "Unique name of the version."},
+    )
+
+    def _validate_version_name(self, version_name: Optional[str]):
+        # Allow None if optional; enforce non-empty string if required
+        if version_name is None:
+            return None
+        return version_name
+
     def _validate_applications(self, applications: List[Dict[str, Any]]):
         if not isinstance(applications, list):
             raise TypeError("'applications' must be a list.")
@@ -390,6 +403,19 @@ tracing_config: # (Optional) Configuration options for tracing.
 
         return tracing_config
 
+    tags: Optional[Dict[str, str]] = field(
+        default=None, metadata={"docstring": "Tags to associate with the service."},
+    )
+
+    def _validate_tags(self, tags: Optional[Dict[str, str]]):
+        if tags is None:
+            return
+        if not isinstance(tags, dict):
+            raise TypeError("'tags' must be a Dict[str, str].")
+        for k, v in tags.items():
+            if not isinstance(k, str) or not isinstance(v, str):
+                raise TypeError("'tags' must be a Dict[str, str].")
+
 
 class ServiceState(ModelEnum):
     """Current state of a service."""
@@ -487,6 +513,7 @@ id: service2_uz6l8yhy2as5wrer3shzj6kh67
 state: RUNNING
 primary_version:
   id: 601bd56c4b
+  name: v1
   state: RUNNING
   weight: 100
   created_at: 2025-04-18 17:21:28.323174+00:00
@@ -502,6 +529,15 @@ primary_version:
         if not isinstance(id, str):
             raise TypeError("'id' must be a string.")
 
+    name: str = field(
+        metadata={"docstring": "Human-readable name of the service version."}
+    )
+
+    def _validate_name(self, name: str):
+        if name is None:
+            return None
+        return name
+
     state: Union[ServiceVersionState, str] = field(
         metadata={"docstring": "Current state of the service version."}
     )
@@ -688,6 +724,26 @@ primary_version:
         if project is not None and not isinstance(project, str):
             raise TypeError("project must be a string.")
 
+    versions: Optional[List[ServiceVersionStatus]] = field(
+        default=None,
+        repr=False,
+        metadata={
+            "docstring": "All active versions of the service. For multi-version services, this contains all versions with their traffic weights."
+        },
+    )
+
+    def _validate_versions(
+        self, versions: Optional[List[ServiceVersionStatus]]
+    ) -> Optional[List[ServiceVersionStatus]]:
+        if versions is None:
+            return None
+        if not isinstance(versions, list):
+            raise TypeError("'versions' must be a list.")
+        for v in versions:
+            if not isinstance(v, ServiceVersionStatus):
+                raise TypeError("'versions' must be a list of ServiceVersionStatus.")
+        return versions
+
 
 class ServiceSortField(ModelEnum):
     """Fields available for sorting services."""

anyscale/shared_anyscale_utils/latest_ray_version.py

@@ -1,3 +1,3 @@
 # AUTOGENERATED - modify shared_anyscale_util in root directory to make changes
 # RAY_RELEASE_UPDATE: managed by release automation.
-LATEST_RAY_VERSION = "2.50.0"
+LATEST_RAY_VERSION = "2.51.0"

anyscale/version.py

@@ -1 +1 @@
-__version__ = "0.26.69"
+__version__ = "0.26.71"

anyscale/workspace/_private/workspace_sdk.py

@@ -169,6 +169,7 @@ class PrivateWorkspaceSDK(WorkloadSDK):
                 cluster_environment_build_id=build_id,
                 idle_timeout_minutes=config.idle_termination_minutes,
                 cloud_id=cloud_id,
+                tags=getattr(config, "tags", None),
                 skip_start=True,
             )
         )

anyscale/workspace/models.py

@@ -53,6 +53,9 @@ idle_termination_minutes: 220
 env_vars:
     key: value
 requirements: /tmp/requirements.txt
+tags:
+    team: mlops
+    env: prod
 """
 
     name: Optional[str] = field(
@@ -88,6 +91,19 @@ requirements: /tmp/requirements.txt
         if containerfile is not None and not isinstance(containerfile, str):
             raise TypeError("'containerfile' must be a string.")
 
+    tags: Optional[Dict[str, str]] = field(
+        default=None, metadata={"docstring": "Tags to associate with the workspace."},
+    )
+
+    def _validate_tags(self, tags: Optional[Dict[str, str]]):
+        if tags is None:
+            return
+        if not isinstance(tags, dict):
+            raise TypeError("'tags' must be a Dict[str, str].")
+        for k, v in tags.items():
+            if not isinstance(k, str) or not isinstance(v, str):
+                raise TypeError("'tags' must be a Dict[str, str].")
+
     compute_config: Union[ComputeConfigType, Dict, str, None] = field(
         default=None,
         metadata={
@@ -215,6 +231,9 @@ idle_termination_minutes: 220
 env_vars:
     key: value
 requirements: /tmp/requirements.txt
+tags:
+  team: mlops
+  env: prod
 """
 
     project: Optional[str] = field(

{anyscale-0.26.69.dist-info → anyscale-0.26.71.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: anyscale
-Version: 0.26.69
+Version: 0.26.71
 Summary: Command Line Interface for Anyscale
 Author: Anyscale Inc.
 License: AS License