Porter | Back to home

 

Porter Agent Docker Image

The getporter/porter-agent Docker image is intended for use by the Porter Operator which runs on Kubernetes. If you need to run Porter in a local container, not on Kubernetes, you should use the porter client image.

It has tags that match what is available from our install page: latest, canary and specific versions such as v0.38.1.

The configuration file for Porter should be mounted in a volume to /porter-config. The image will copy the configuration file into PORTER_HOME when the container starts and then run the specified porter command, similar to the porter client image.

Example

This set of manifests performs the follow actions:

  1. Create a namespace named porter-agent-test.
  2. Create a role named porter-agent-role with sufficient permissions to run Porter.
  3. Create a service account named porter-agent and add it to the porter-agent-role.
  4. Create a persistent volume claim named porter-hello-shared that Porter uses to share data with the bundle’s pod.
  5. Create a pod named porter-hello-3591 that executes the install action for the getporter/porter-hello:v0.1.1 bundle using the kubernetes driver. The kubernetes driver executes the bundle in a pod on a Kubernetes cluster.

Run the following command to run the porter-hello bundle on a cluster to try it out.

kubectl apply -f https://porter.sh/src/examples/porter-agent-manifest.yaml