Skip to content

First deployment

Brice Amen edited this page Sep 4, 2024 · 2 revisions

First deployment example

💡 This section guides you through the initial deployment using the Nginx container image as an example.

Pull the image

To begin, pull the Nginx image with the following command:

podman pull nginx:latest
# or
docker pull nginx:latest

Deploy the Image

Deploy the image using the gordon deploy command:

gordon deploy nginx -p 80 -t nginx.foobar.com

⚠️ The -p (port) parameter corresponds to your application's internal container port. This is used for Traefik to setup the loadbalancer which route traffic to the container's internal port without exposing it directly.

💡 NB:

  • Omitting a :tag when specifying the image defaults to :latest.
  • Omitting protocol for the ports defaults to /tcp.
  • Omitting HTTP or HTTPS for your domain will default to HTTPS.

If the deployment is successful, you will receive this message:

Deployment successful!
Your application is now available at: https://nginx.foobar.com

💡 Troubleshooting Tip: If the image upload succeeds but Traefik cannot expose your container, you may edit the container configuration via the backend web UI.

Work in progress

  • Using godon deploy nginx without parameters will push the image and provide a URL to create the container.
  • Executing gordon push nginx will simply push the image to the backend.

Clone this wiki locally