public inbox for pve-devel@lists.proxmox.com
 help / color / mirror / Atom feed
From: Leo Nunner <l.nunner@proxmox.com>
To: pve-devel@lists.proxmox.com
Subject: [pve-devel] [PATCH docs] storage: more documentation for content-dirs
Date: Wed,  7 Jun 2023 15:32:16 +0200	[thread overview]
Message-ID: <20230607133216.216761-1-l.nunner@proxmox.com> (raw)

give an overview over vtypes and also document the option for
cephfs.

Signed-off-by: Leo Nunner <l.nunner@proxmox.com>
---
 pve-storage-cephfs.adoc |  4 ++++
 pve-storage-dir.adoc    | 20 ++++++++++++++++++++
 2 files changed, 24 insertions(+)

diff --git a/pve-storage-cephfs.adoc b/pve-storage-cephfs.adoc
index c10976b..6873660 100644
--- a/pve-storage-cephfs.adoc
+++ b/pve-storage-cephfs.adoc
@@ -57,6 +57,10 @@ fuse::
 Access CephFS through FUSE, instead of the kernel client. Optional, defaults
 to `0`.
 
+content-dirs::
+
+Overrides for the default directory layout. Optional.
+
 .Configuration example for an external Ceph cluster (`/etc/pve/storage.cfg`)
 ----
 cephfs: cephfs-external
diff --git a/pve-storage-dir.adoc b/pve-storage-dir.adoc
index 3367394..61dddeb 100644
--- a/pve-storage-dir.adoc
+++ b/pve-storage-dir.adoc
@@ -59,6 +59,26 @@ in the following format:
 Where `vtype` is one of the allowed content types for the storage, and
 `path` is a path relative to the mountpoint of the storage.
 
+.Overrides
+[width="100%",cols="d,m,m",options="header"]
+|===========================================================
+|Content type        |vtype     | Example
+|VM images           |`images`  | images=sub/dir
+|ISO images          |`iso`     | iso=sub/dir
+|Container templates |`vztmpl`  | vztmpl=sub/dir
+|Backup files        |`backup`  | backup=sub/dir
+|Snippets            |`sinppet` | snippet=sub/dir
+|===========================================================
+
+So an override for VM images would look like `images=dir/path`, an
+override for ISO images like `iso=dir/path` etc. They can also be
+combined in a list:
+
+----
+content-dirs images=dir/path,iso=dir/path
+----
+
+
 .Configuration Example (`/etc/pve/storage.cfg`)
 ----
 dir: backup
-- 
2.30.2





             reply	other threads:[~2023-06-07 13:32 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2023-06-07 13:32 Leo Nunner [this message]
2023-08-21  9:10 ` Fiona Ebner

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20230607133216.216761-1-l.nunner@proxmox.com \
    --to=l.nunner@proxmox.com \
    --cc=pve-devel@lists.proxmox.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
Service provided by Proxmox Server Solutions GmbH | Privacy | Legal