From 1d5b9970f70eb902aec8db9835800a786c661a81 Mon Sep 17 00:00:00 2001
From: lorenzo farnararo <lorenzo.farnararo@suse.com>
Date: Thu, 3 Oct 2024 14:32:01 +0200
Subject: [PATCH] add FAQ for deploy command

---
 Gemfile.lock            |  4 ++++
 docs/commands/deploy.md | 22 ++++++++++++++++++++++
 2 files changed, 26 insertions(+)

diff --git a/Gemfile.lock b/Gemfile.lock
index d64b4b2..e47e461 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -42,6 +42,7 @@ GEM
     faraday-net_http (3.3.0)
       net-http
     ffi (1.17.0-arm64-darwin)
+    ffi (1.17.0-x86_64-linux-gnu)
     forwardable-extended (2.6.0)
     gemoji (4.1.0)
     github-pages (232)
@@ -232,6 +233,8 @@ GEM
       uri
     nokogiri (1.16.7-arm64-darwin)
       racc (~> 1.4)
+    nokogiri (1.16.7-x86_64-linux)
+      racc (~> 1.4)
     octokit (4.25.1)
       faraday (>= 1, < 3)
       sawyer (~> 0.9)
@@ -270,6 +273,7 @@ PLATFORMS
   arm64-darwin-22
   arm64-darwin-23
   arm64-darwin-24
+  x86_64-linux
 
 DEPENDENCIES
   github-pages
diff --git a/docs/commands/deploy.md b/docs/commands/deploy.md
index 91576c7..d260005 100644
--- a/docs/commands/deploy.md
+++ b/docs/commands/deploy.md
@@ -37,3 +37,25 @@ Options:
   -H, [--skip-hooks]                                 # Don't run hooks
                                                      # Default: false
 ```
+
+# FAQ
+
+## Skip building an deploy some public docker image
+
+See [this Github issue](https://github.com/basecamp/kamal/issues/497)
+
+In order to use pre build images, you have to add a `service` label with the name of kamal service.
+
+For example, a `deploy.yml` file starting with:
+
+```yaml
+# Name of your application. Used to uniquely configure containers.
+service: name-of-service
+
+# Name of the container image.
+image: some/image
+
+...
+```
+
+will require the label `label=service=name-of-service`.