[Feature]: Shutdown time rather than timeout, preferably on the command line

[jsadusk]

Problem

For dev environments specifically, I don't usually want an environment to last a specific duration. I want the environment to shutdown at a specific time. In other words, regardless of when I start working, I want it to shut down at 6:00. Currently there's no way to do this other than editing my workstation yml each time, and figuring out in my head how many hours I want to run right now.

Solution

It would be a usability enhancement for me to just type dstack apply --shutdown-time=6:00pm .... Alternatively, a minimal enhancement would be to allow the apply command line to override settings in the yaml. So in that case dstack apply --config-override="max_duration: 6h" or something to that effect.

Workaround

I have written scripts to take a templated dev environment yaml and insert the values I want, but this is a very roundabout solution.

Would you like to help us implement this feature by sending a PR?

Maybe

[peterschmidt85]

cc @jvstme @r4victor
This may also relate to #2836 when we want to start something at certain time but then shutdown it also at certain time.

[r4victor]

@jsadusk, you can already specify max_duration via the cli:

dstack apply --max-duration 3h
 Project              main                           
 User                 admin                          
 Configuration        .dstack.yml                    
 Type                 dev-environment                
 Resources            cpu=2.. mem=8GB.. disk=100GB.. 
 Spot policy          auto                           
 Max price            -                              
 Retry policy         -                              
 Creation policy      reuse-or-create                
 Idle duration        5m                             
 Max duration         3h                             
 Inactivity duration  -                              
 Reservation          -

✗ dstack apply --help dev-environment
Usage: dstack apply [--project NAME] [-h [TYPE]] [-f FILE] [-y] [--force] [-d]
                    [-P REPO] [--repo-branch REPO_BRANCH]
                    [--repo-hash REPO_HASH] [--no-repo] [-t OAUTH_TOKEN]
                    [--git-identity SSH_PRIVATE_KEY]
                    [--ssh-identity SSH_PRIVATE_KEY] [--local] [-n RUN_NAME]
                    [--max-offers MAX_OFFERS] [-e KEY[=VALUE]] [--cpu SPEC]
                    [--gpu SPEC] [--disk RANGE] [--profile NAME]
                    [--max-price PRICE] [--max-duration DURATION] [-b NAME]
                    [-r NAME] [--instance-type NAME] [--fleet NAME]
                    [-R | --dont-destroy | --idle-duration IDLE_DURATION]
                    [--spot | --on-demand | --spot-auto | --spot-policy POLICY]
                    [--retry | --no-retry | --retry-duration DURATION]
                    [-p MAPPING] [--host HOST]

Options:
  --project NAME        The name of the project. Defaults to $DSTACK_PROJECT
  -h, --help [TYPE]     Show this help message and exit.
  -f, --file FILE       The path to the configuration file. Defaults to
                        $PWD/.dstack.yml
  -y, --yes             Do not ask for confirmation
  --force               Force apply when no changes detected
  -d, --detach          Exit immediately after submitting configuration
  -p, --port MAPPING    Exposed port or mapping
  --host HOST           Local address to bind. Defaults to localhost

Repo Options:
  -P, --repo REPO       The repo to use for the run. Can be a local path or a
                        Git repo URL.
  --repo-branch REPO_BRANCH
                        The repo branch to use for the run
  --repo-hash REPO_HASH
                        The hash of the repo commit to use for the run
  --no-repo             Do not use any repo for the run
  -t, --token OAUTH_TOKEN
                        An authentication token to access a private Git repo
  --git-identity SSH_PRIVATE_KEY
                        The private SSH key path to access a private Git repo
  --ssh-identity SSH_PRIVATE_KEY
                        The private SSH key path for SSH tunneling
  --local               Do not use Git

Dev-Environment Options:
  -n, --name RUN_NAME   The name of the run. If not specified, a random name is
                        assigned
  --max-offers MAX_OFFERS
                        Number of offers to show in the run plan
  -e, --env KEY[=VALUE]
                        Environment variables
  --cpu SPEC            Request CPU for the run. The format is ARCH:COUNT (all
                        parts are optional)
  --gpu SPEC            Request GPU for the run. The format is
                        NAME:COUNT:MEMORY (all parts are optional)
  --disk RANGE          Request the size range of disk for the run. Example
                        --disk 100GB...

Profile:
  --profile NAME        The name of the profile. Defaults to $DSTACK_PROFILE
  --max-price PRICE     The maximum price per hour, in dollars
  --max-duration DURATION
                        The maximum duration of the run
  -b, --backend NAME    The backends that will be tried for provisioning
  -r, --region NAME     The regions that will be tried for provisioning
  --instance-type NAME  The cloud-specific instance types that will be tried
                        for provisioning

Fleets:
  --fleet NAME          Consider only instances from the specified fleet(s) for
                        reuse
  -R, --reuse           Reuse an existing instance from fleet (do not provision
                        a new one)
  --dont-destroy        Do not destroy instance after the run is finished (if
                        the run provisions a new instance)
  --idle-duration IDLE_DURATION
                        Time to wait before destroying the idle instance (if
                        the run provisions a new instance)

Spot Policy:
  --spot                Consider only spot instances
  --on-demand           Consider only on-demand instances
  --spot-auto           Consider both spot and on-demand instances
  --spot-policy POLICY  One of spot, on-demand, auto

Retry Policy:
  --retry
  --no-retry
  --retry-duration DURATION