Difference between revisions of "Meta files"

From Univention Wiki

Jump to: navigation, search
(Link to new documentation)
 
Line 1: Line 1:
[[Category:App Center Developer Guide]]
+
#REDIRECT [[App Center Developer Guide]]
 
 
Each App comes with some meta data. It describes the App both for the user (a descriptive text, screenshots,
 
etc.) and the App Center (the name of the Docker image, required ports, etc.).
 
 
 
;''Important'': The [[Provider Portal/Apps|Provider Portal]] hides the actual files and presents a web form where you can upload images, set parameters and so on.
 
 
 
= The ini file =
 
 
 
The single most important file is the ini file. Without it, there is no App. It is a simple text file with at least
 
a section
 
<pre>
 
[Application]
 
</pre>
 
and some variables and their corresponding values in the format:
 
<pre>
 
Variable=value
 
</pre>
 
 
 
The variables have their [[Meta_files/ini|own page]].
 
 
 
This example file is taken directly from the App Center. It describes the App Jenkins:
 
 
 
<pre>
 
[Application]
 
ID=jenkins
 
Code=JE
 
Logo=jenkins.svg
 
LogoDetailPage=jenkins_with_title.svg
 
Name=Jenkins
 
Version=1.642.2
 
License=free
 
DockerImage=docker.software-univention.de/jenkins:1.642.2
 
NotifyVendor=True
 
NotificationEmail=appcenter-reporting@univention.de
 
Vendor=Jenkins Project
 
WebsiteVendor=https://jenkins-ci.org/
 
Maintainer=Univention GmbH
 
WebsiteMaintainer=https://www.univention.com/
 
Contact=feedback@univention.de
 
SupportURL=https://wiki.jenkins-ci.org/display/JENKINS/Commercial+Support
 
DockerScriptInit=
 
DockerScriptStoreData=
 
DockerScriptRestoreDataBeforeSetup=
 
DockerScriptRestoreDataAfterSetup=
 
DockerScriptSetup=
 
WebInterface=/jenkins/
 
WebinterfacePortHTTP=8080
 
WebinterfacePortHTTPS=8080
 
WebInterfaceProxyScheme=http
 
PortsExclusive=50000
 
UCSOverviewCategory=False
 
RequiredUCSVersion=4.1-1
 
License=free
 
Categories=Collaboration
 
Description=Jenkins is a continuous integration tool.
 
LongDescription=<p>Jenkins is the leading open source automation server.
 
  Built with Java, it provides
 
  hundreds of plugins to support building, testing, deploying and
 
  automation for virtually any
 
  software project.</p>
 
  <p>This is a fully functional Jenkins server, provided by the Jenkins
 
  project.
 
  It is based on the Long Term Support release <a target="_blank"
 
  href="http://jenkins-ci.org/">http://jenkins-ci.org/</a>.
 
  It can be used for free in the context of MIT-Lizenz and Creative
 
  Commons Attribution Share-Alike respectively.
 
  See <a target="_blank" href="https://hub.docker.com/_/jenkins/">https://hub.docker.com/_/jenkins/</a>
 
  for more information.</p>
 
 
 
[de]
 
Description=Jenkins ist ein Tool zur kontinuierlichen Integration.
 
LongDescription=<p>Jenkins ist der führende Open-Source-
 
  Automatisierungsserver. Jenkins ist in Java implementiert,
 
  es bietet hunderte von Plugins, die das Erstellen, Testen, in Betrieb
 
  nehmen und Automatisieren für nahezu jedes
 
  Software-Projekt unterstützen.</p>
 
  <p>Dies ist ein voll funktionsfähiger, vom Jenkins-Projekt bereit
 
  gestellter Jenkins Server. Er basiert auf dem Long
 
  Term Support Release <a target="_blank" href="http://jenkins-
 
  ci.org/">http://jenkins-ci.org/</a>. Er kann im Rahmen der MIT-Lizenz
 
  bzw. Creative Commons Attribution Share-Alike frei benutzt werden.
 
  Siehe
 
  <a target="_blank" href="https://hub.docker.com/_/jenkins/">https://hub.docker.com/_/jenkins/</a>
 
  für weitere Informationen.</p>
 
WebsiteMaintainer=https://www.univention.de/
 
</pre>
 
 
 
 
 
= Logos, Screenshots =
 
 
 
Along with the ini file, several pictures may be used to showcase the App.
 
You should add the logo of the App in a squared and a stretched version in SVG format named as in the ini
 
file. Compare [https://appcenter.software-univention.de/meta-inf/4.1/jenkins/jenkins.svg the one] and [https://appcenter.software-univention.de/meta-inf/4.1/jenkins/jenkins_with_title.svg the other] logo file of Jenkins.
 
You may add screenshots as described in Thumbnails. Or you specify one or more YouTube URLs and
 
upload the videos there.
 
 
 
= READMEs, License file =
 
 
 
There are several files that may be used to explain the App in depth in various situations (in the lifecycle
 
within the App Center).
 
 
 
;''NOTE'': All of the following files may be localized. That means that you may provide two versions of the file, one ending in "_DE", one in "_EN", e.g., <tt>README_DE</tt> and <tt>README_EN</tt>. All files support (and require) HTML if you want to format it. Mere newlines are not automatically formatted, they will be removed because of the HTML view of the file.
 
 
 
;LICENSE_AGREEMENT: If you require the user to confirm a license agreement before installation, provide this file.
 
;README: The most important readme file. Shown in the detail page of the App Center, if the App is installed. Therefore, it should provide first steps to take to actually use the App, e.g. what to do to use existing UCS users to authenticate against your App or an initial password to finish any setup.
 
;README_INSTALL: A file containing important information for the end user which is shown just before the installation starts.
 
;README_POST_INSTALL: A file containing important information for the end user which is shown just after the installation is completed.
 
;README_UPDATE: A file containing important information for the end user which is shown just before the update starts. Use case: Changelog.
 
;README_POST_UPDATE: A file containing important information for the end user which is shown just after the update is completed.
 
;README_UNINSTALL: A file containing important information for the end user which is shown just before the uninstallation starts. Use case: Warning about broken services.
 
;README_POST_UNINSTALL: A file containing important information for the end user which is shown just after the uninstallation is completed. Use case: Instructions how to clean up if the App was unable to do it automatically.
 

Latest revision as of 15:04, 27 August 2018

Personal tools