Difference between revisions of "Docker Apps/Files"

From Univention Wiki

Jump to: navigation, search
(Created page with "Category:App Center Developer Guide An App may ship additional files along with the ini file. These are not scripts as Docker Apps/Container Scripts, just plain text...")
 
Line 18: Line 18:
 
</pre>
 
</pre>
  
These directories may be used for any purpose. For Docker Apps, they are mounted into the container at the same place as read-write. Thus, they can be used to store data that shall survive a container exchange. Either by configuring the App's directories to point to these directories directly, or by copying important data in the store_data script (See [[Docker Apps/Container Scripts]].
+
These directories may be used for any purpose. For Docker Apps, they are mounted into the container at the same place as read-write. Thus, they can be used to store data that shall survive a container exchange. Either by configuring the App's directories to point to these directories directly, or by copying important data in the store_data script (See [[Docker Apps/Container Scripts]]).

Revision as of 11:20, 11 October 2016


An App may ship additional files along with the ini file. These are not scripts as Docker Apps/Container Scripts, just plain text files.

env
An environment file used during the creation of the Docker Container. It contains static configuration options passed to the container via docker create ... --env ${env}. See the Docker Documentation.
univention-config-registry-variables
This file contains (a superset of) UCR variable definitions. These definitions exist on a regular UCS to describe the specific variables in the UCR database. In this context, they are used to set UCR variables in the Docker Container. If this file is present, there will be a form before the installation of the App and after the installation on a separate page within the App Center module ("App Settings"). Further information can be found in Section Integration with UCS/Settings.
schema
A schema extension for LDAP. This is useful if you want to, e.g., extend the user objects of UCS by an attribute like "This user may use the App" (see Section Integration with UCS/Join). The file will be copied to /usr/share/univention-appcenter/apps/APPID/APPID.schema during installation. See the LDAP documentation for the syntax of a schema file. If you need an "official" OID namespace, Univention can provide one. It is important to note that shipping this file alone is not enough. You need to register it in the join script (see Section Docker Apps/Container Scripts) via ucs_registerLDAPExtension "$@" --schema "/usr/share/univention-appcenter/apps/$APP/$APP.schema".

Directories

There are two directories that are created for every App before actually installing it:

/var/lib/univention-appcenter/apps/$appid/data
/var/lib/univention-appcenter/apps/$appid/conf

These directories may be used for any purpose. For Docker Apps, they are mounted into the container at the same place as read-write. Thus, they can be used to store data that shall survive a container exchange. Either by configuring the App's directories to point to these directories directly, or by copying important data in the store_data script (See Docker Apps/Container Scripts).

Personal tools