diff --git a/source/contributing/services/backups.rst b/source/contributing/services/backups.rst new file mode 100644 index 0000000..87d6e6b --- /dev/null +++ b/source/contributing/services/backups.rst @@ -0,0 +1,29 @@ +.. _service_backups: + +*************** +Service Backups +*************** + +Everything within the root of the mounted volume directory will be stored in an EmbassyOS backup. This includes the config (config.yaml) and properties (stats.yaml) files, as well as any other persisted data within the volume directory. + +For restoration purposes, it might be beneficial to ignore certain files or folders. For instance, ignore the shared/public folder that is mounted for dependencies that expose this feature as it causes data inconsistencies on restore. + +In this case, create a `.backupignore` file. This file contains a list of relative paths to the ignored files. + + +Example +======= + +The `btcpayserver wrapper `_ demonstrates a good use of a backupignore template. + +Ultimately, ``/datadir/.backupignore`` gets populated with: + +.. code:: + + /root/volumes/btcpayserver/start9/public + /root/volumes/btcpayserver/start9/shared + +.. role:: raw-html(raw) + :format: html + +:raw-html:`
` \ No newline at end of file diff --git a/source/contributing/services/index.rst b/source/contributing/services/index.rst index e0f8794..dca0b86 100644 --- a/source/contributing/services/index.rst +++ b/source/contributing/services/index.rst @@ -31,6 +31,7 @@ Happy building! Config Properties Instructions + Backups Submission process ------------------ diff --git a/source/contributing/services/wrapper.rst b/source/contributing/services/wrapper.rst index 6104e9d..e4ebad3 100644 --- a/source/contributing/services/wrapper.rst +++ b/source/contributing/services/wrapper.rst @@ -26,16 +26,12 @@ The project structure should be used as a model: ├── Dockerfile ├── Makefile (optional) ├── README.md - ├── assets - │ ├── httpd.conf (optional) - │ └── httpd.conf.template (optional) ├── config_rules.yaml ├── config_spec.yaml ├── ├── docker_entrypoint.sh ├── docs │ └── instructions.md - ├── instructions.md -> docs/instructions.md (symlink) └── manifest.yaml Submodule @@ -43,20 +39,4 @@ Submodule `Git sub-modules `_ allow use of another project while in the working project directory. Setting up this feature enables linking of the source service repository so that it's context is available. -Run ``git submodule add `` - -Assets -====== - -.. warning:: - - *This section is being deprecated in favor of baking assets into the Docker image, and moved into the mountpoint at runtime if necessary* - -Whenever a service is stopped, any file that is not contained within in the ``/assets`` directory will be cleared from memory. Any unsaved changes will be reverted. This folder acts as a persistance storage container. - -In this folder belongs any assets that are unique configurations to your service. For instance, bitcoind's ``.conf`` file is saved here. - -.. role:: raw-html(raw) - :format: html - -:raw-html:`
` \ No newline at end of file +Run ``git submodule add `` \ No newline at end of file