def flags(parser):
"""Add command line flags for the `create` subcommand.
Args:
parser: The argparse parser to which to add the flags.
"""
parser.add_argument(
'instance',
metavar='NAME',
help='a name for the newly created instance')
parser.add_argument(
'--image-name',
dest='image_name',
default='gcr.io/cloud-datalab/datalab:local',
help=(
'name of the Datalab image to run.'
'\n\n'
'If not specified, this defaults to the most recently\n'
'published image.'))
parser.add_argument(
'--disk-name',
dest='disk_name',
default=None,
help=(
'name of the persistent disk used to store notebooks.'
'\n\n'
'If not specified, this defaults to having a name based\n'
'on the instance name.'))
parser.add_argument(
'--disk-size-gb',
type=int,
dest='disk_size_gb',
default=_DATALAB_DEFAULT_DISK_SIZE_GB,
help='size of the persistent disk in GB.')
parser.add_argument(
'--no-connect',
dest='no_connect',
action='store_true',
default=False,
help='do not connect to the newly created instance')
connect.connection_flags(parser)
return
def flags(parser):
"""Add command line flags for the `create` subcommand.
Args:
parser: The argparse parser to which to add the flags.
"""
parser.add_argument('instance',
metavar='NAME',
help='a name for the newly created instance')
parser.add_argument(
'--image-name',
dest='image_name',
default='gcr.io/cloud-datalab/datalab:latest',
help=('name of the Datalab image to run.'
'\n\n'
'If not specified, this defaults to the most recently\n'
'published image.'))
parser.add_argument(
'--disk-name',
dest='disk_name',
default=None,
help=('name of the persistent disk used to store notebooks.'
'\n\n'
'If not specified, this defaults to having a name based\n'
'on the instance name.'))
parser.add_argument('--disk-size-gb',
type=int,
dest='disk_size_gb',
default=_DATALAB_DEFAULT_DISK_SIZE_GB,
help='size of the persistent disk in GB.')
parser.add_argument(
'--idle-timeout',
dest='idle_timeout',
default=defaultIdleTimeout,
help=('interval after which an idle Datalab instance will shut down.'
'\n\n'
'You can specify a mix of days, hours, minutes and seconds\n'
'using those names or d, h, m and s, for example "1h 30m".\n'
'Specify 0s to disable.'))
parser.add_argument(
'--machine-type',
dest='machine_type',
default='n1-standard-1',
help=('the machine type of the instance.'
'\n\n'
'To get a list of available machine types, run '
'\'gcloud compute machine-types list\'.'
'\n\n'
'If not specified, the default type is n1-standard-1.'))
parser.add_argument('--no-connect',
dest='no_connect',
action='store_true',
default=False,
help='do not connect to the newly created instance')
parser.add_argument(
'--no-backups',
dest='no_backups',
action='store_true',
default=False,
help='do not automatically backup the disk contents to GCS')
parser.add_argument(
'--no-create-repository',
dest='no_create_repository',
action='store_true',
default=False,
help='do not create the datalab-notebooks repository if it is missing')
parser.add_argument(
'--log-level',
dest='log_level',
choices=['trace', 'debug', 'info', 'warn', 'error', 'fatal'],
default='warn',
help=('the log level for Datalab instance.'
'\n\n'
'This is the threshold under which log entries from the '
'Datalab instance will not be written to StackDriver logging.'
'\n\n'
'The default log level is "warn".'))
parser.add_argument(
'--for-user',
dest='for_user',
help='create the datalab instance on behalf of the specified user')
parser.add_argument(
'--service-account',
dest='service_account',
help=('A service account is an identity attached to the instance. '
'Its access tokens can be accessed through the instance '
'metadata server and are used to authenticate API calls made '
'from Datalab. The account can be either an email address or '
'an alias corresponding to a service account. You can '
'explicitly specify the Compute Engine default service account '
'using the \'default\' alias.'
'\n\n'
'If not provided, the instance will get project\'s default '
'service account.'))
connect.connection_flags(parser)
return
def flags(parser):
"""Add command line flags for the `create` subcommand.
Args:
parser: The argparse parser to which to add the flags.
"""
parser.add_argument(
'instance',
metavar='NAME',
help='a name for the newly created instance')
parser.add_argument(
'--image-name',
dest='image_name',
default='gcr.io/cloud-datalab/datalab:latest',
help=(
'name of the Datalab image to run.'
'\n\n'
'If not specified, this defaults to the most recently\n'
'published image.'))
parser.add_argument(
'--disk-name',
dest='disk_name',
default=None,
help=(
'name of the persistent disk used to store notebooks.'
'\n\n'
'If not specified, this defaults to having a name based\n'
'on the instance name.'))
parser.add_argument(
'--disk-size-gb',
type=int,
dest='disk_size_gb',
default=_DATALAB_DEFAULT_DISK_SIZE_GB,
help='size of the persistent disk in GB.')
parser.add_argument(
'--network-name',
dest='network_name',
default=_DATALAB_NETWORK,
help='name of the network to which the instance will be attached.')
parser.add_argument(
'--idle-timeout',
dest='idle_timeout',
default=None,
help=(
'interval after which an idle Datalab instance will shut down.'
'\n\n'
'You can specify a mix of days, hours, minutes and seconds\n'
'using those names or d, h, m and s, for example "1h 30m".\n'
'Specify 0s to disable.'))
parser.add_argument(
'--machine-type',
dest='machine_type',
default='n1-standard-1',
help=(
'the machine type of the instance.'
'\n\n'
'To get a list of available machine types, run '
'\'gcloud compute machine-types list\'.'
'\n\n'
'If not specified, the default type is n1-standard-1.'))
parser.add_argument(
'--no-connect',
dest='no_connect',
action='store_true',
default=False,
help='do not connect to the newly created instance')
parser.add_argument(
'--no-swap',
dest='no_swap',
action='store_true',
default=False,
help='do not enable swap on the newly created instance')
parser.add_argument(
'--no-backups',
dest='no_backups',
action='store_true',
default=False,
help='do not automatically backup the disk contents to GCS')
parser.add_argument(
'--no-create-repository',
dest='no_create_repository',
action='store_true',
default=False,
help='do not create the datalab-notebooks repository if it is missing')
parser.add_argument(
'--log-level',
dest='log_level',
choices=['trace', 'debug', 'info', 'warn', 'error', 'fatal'],
default='warn',
help=(
'the log level for Datalab instance.'
'\n\n'
'This is the threshold under which log entries from the '
'Datalab instance will not be written to StackDriver logging.'
'\n\n'
'The default log level is "warn".'))
parser.add_argument(
'--for-user',
dest='for_user',
help='create the datalab instance on behalf of the specified user')
parser.add_argument(
'--service-account',
dest='service_account',
help=('A service account is an identity attached to the instance. '
'Its access tokens can be accessed through the instance '
'metadata server and are used to authenticate API calls made '
'from Datalab. The account can be either an email address or '
'an alias corresponding to a service account. You can '
'explicitly specify the Compute Engine default service account '
'using the \'default\' alias.'
'\n\n'
'If not provided, the instance will get project\'s default '
'service account.'))
connect.connection_flags(parser)
return
