run

Create and run a pod with particular image.

Usage: pi run NAME [OPTIONS] [-i] [-t] --image=image [--env="key=value"] -- [COMMAND] [args...]

Execute a command in a container

          -e, --access-key                API access key
          -k, --secret-key                API secret key
          -r, --region                    Region name, default: gcp-us-central1
          -u, --user                      Username
          --active-deadline-seconds       Optional duration in seconds the pod may be active on the node relative to StartTime before the system will actively try to mark it failed and kill associated containers. Value must be a positive integer.
          --command=false                 If true and extra arguments are present, use them as the 'command' field in the container, rather than the 'args' field which is the default.
          --env                           Environment variables to set in the container
          --image                         The image for the container to run.
          --image-pull-policy             The image pull policy for the container. If left empty, this value will not be specified by the client and defaulted by the server
          --image-pull-secrets            The secret for the private docker registry, comma separated.
          -l, --labels                    Comma separated labels to apply to the pod(s). Will override previous values.
          --limits                        The resource requirement limits for this container. For example, 'cpu=200m,memory=512Mi'.
          --pod-running-timeout=1m0s      The length of time (like 5s, 2m, or 3h, higher than zero) to wait until at least one pod is running
          --restart                       The restart policy for this Pod. Default 'Always'
          --rm                            If true, delete resources created in this command for attached containers.
          --size                          The size for the pod (e.g. s1, s2, s3, s4, m1, m2, m3, l1, l2, l3, l4, l5, l6). Default 's4'
          -i, --stdin                     Keep stdin open on the container(s) in the pod, even if nothing is attached.
          -t, --tty                       Allocated a TTY for each container in the pod.
          --volume                        Pod volumes to mount into the container's filesystem.

// Start a single instance of nginx.
$ pi run nginx --image=nginx

// Start a single instance of nginx and set environment variables "DNS_DOMAIN=cluster" and "POD_NAMESPACE=default" in the container.
$ pi run nginx --image=nginx --env="DNS_DOMAIN=cluster" --env="POD_NAMESPACE=default"

// Start a single instance of nginx and set labels "app=nginx" and "env=prod" in the container.
$ pi run nginx --image=nginx --labels="app=nginx,env=prod"

// Start a pod of busybox and keep it in the foreground, don't restart it if it exits.
$ pi run -it busybox --image=busybox --restart=Never -- sh

// Start the nginx container using a specified command and custom arguments.
$ pi run nginx --image=nginx -- <cmd> <arg1> ... <argN>

// Start the nginx container using a specified command and custom arguments.
$ pi run nginx --rm --image=nginx -- echo hello world

// Start a pod of nginx with large pod size
$ pi run -it nginx-large-l4 --image=nginx --size=l4 --pod-running-timeout=3m -- sh