porter app
Prerequisites
- You’ve logged in to the Porter CLI after running porter auth login
- You’re connected to the correct project by running porter config set-project
- You’re connected to the correct cluster by running porter config set-cluster
porter app run
The porter app run
command allows users to execute a command on a remote container:
The APP_NAME
is the name of the application on the Porter dashboard.
Running porter app run
spins up an ephemeral copy of your application
container. This container will be deleted when your command completes,
or when you exit your interactive shell session.
To connect to an existing running container, you can specify the -e
flag:
This will launch an interactive shell session through which you can run other commands, like ls
, ps
, etc. If bash
isn’t found on your container, you can also try sh
for a similar result.
porter app build
The porter app build
command builds a new container image for an app based on it’s existing build settings. Any build setting can be overridden with a corresponding flag.
For example, to start a Docker build for an app in the ./frontend
directory, you can run:
porter app push
The porter app push
command pushes a container image to the default registry for the app. This command can be used with the app build
command to build and push an image as discrete steps.
The --tag
flag can be used to specify the image tag to push. Otherwise, the head of the current branch will be used as the tag.
porter app update
The porter app update
command updates the specified app with the provided configuration. This command differs from “porter apply” in that it only updates the app, but does not attempt to build a new image. This is similar to updating the app in the Porter dashboard.
porter app update-tag
porter app update-tag
updates the image of the specified application with the tag provided by the --tag
flag. For example:
This command is functionally equivalent to running either porter apply
or porter app update
with the --tag
flag.