Bug 28597 - App-Center-Dokumentation für Partner
App-Center-Dokumentation für Partner
Status: CLOSED FIXED
Product: UCS
Classification: Unclassified
Component: App Center
UCS 3.0
Other Linux
: P5 normal (vote)
: UCS 3.2
Assigned To: Dirk Wiesenthal
Stefan Gohmann
: interim-3
Depends on:
Blocks:
  Show dependency treegraph
 
Reported: 2012-09-19 10:34 CEST by Alexander Kläser
Modified: 2013-11-19 06:43 CET (History)
3 users (show)

See Also:
What kind of report is it?: ---
What type of bug is this?: ---
Who will be affected by this bug?: ---
How will those affected feel about the bug?: ---
User Pain:
Enterprise Customer affected?:
School Customer affected?:
ISV affected?:
Waiting Support:
Flags outvoted (downgraded) after PO Review:
Ticket number:
Bug group (optional):
Max CVSS v3 score:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Alexander Kläser univentionstaff 2012-09-19 10:34:19 CEST
Für Partner wird eine Wiki-Seite geschrieben, in der alle notwendigen Informationen, Voraussetzungen und Schritte zur Integration ihres Produkts in das App-Center beschrieben werden.
Comment 1 Nico Gulden univentionstaff 2012-09-26 15:31:20 CEST
Der Artikel zur Paketierung von Software für UCS im Wiki sollte auch noch auf UCS 3 aktualisiert werden. Der Artikel wurde zuletzt maßgeblich im November 2010 bearbeitet.

→ Bug #20206
Comment 2 Alexander Kläser univentionstaff 2012-09-27 09:12:53 CEST
Es gibt bereits eine Wiki-Seite mit allgemeinen Informationen bzgl. des App-Centers:

http://wiki.univention.de/index.php?title=App_Center
Comment 3 Alexander Kläser univentionstaff 2012-09-28 16:30:09 CEST
(In reply to comment #2)
> Es gibt bereits eine Wiki-Seite mit allgemeinen Informationen bzgl. des
> App-Centers:
> 
> http://wiki.univention.de/index.php?title=App_Center

Diese Seite habe ich soweit noch etwas erweitert. Ich habe auch eine Beispiel-.ini-Datei verlinkt, die als Vorlage dient.

(In reply to comment #1)
> Der Artikel zur Paketierung von Software für UCS im Wiki sollte auch noch auf
> UCS 3 aktualisiert werden. Der Artikel wurde zuletzt maßgeblich im November
> 2010 bearbeitet.
> 
> → Bug #20206

Stimmt, ich habe ihn auf 3.1-x getaggt.
Comment 4 Stefan Gohmann univentionstaff 2012-10-16 15:53:07 CEST
Nico, kannst du prüfen, ob alles notwendige vorhanden ist?
Comment 5 Nico Gulden univentionstaff 2012-10-24 15:54:45 CEST
(In reply to comment #4)
> Nico, kannst du prüfen, ob alles notwendige vorhanden ist?

In Gesprächen mit Technologiepartnern wurde gefragt, wie es mit Updates und Versionierung aussieht. Momentan ist nur beschrieben, wie das Verfahren aussieht, um Updates für Pakete im App Center bereit zu stellen, aber nicht, wie App Center mit Updates umgeht. 

IMHO sollte hier beschrieben werden, wie es mit Updates für Applikationen innerhalb eines UCS-Minor-Releases und über das Minor-Release hinaus, z.B. zum nächsten Minor- oder sogar zum Major-Release aussieht.

→ REOPENED

Das Wesentliche ist IMHO soweit vorhanden. Ich habe den Artikel auch ins Englische übersetzt und favorisiere, dass es ab Release von UCS 3.1 nur die englische Variante gibt, damit weniger zu pflegen ist.

Im Artikel zur .ini-Datei fehlt noch die Beschreibung für die Option EmailRequired=. Dafür sollte aber auch im App Center Artikel noch das Verfahren für die E-Mailbenachrichtigung beschrieben werden.

→ Das habe ich in Bug #28902 ausgelagert und ich erstelle den Text dafür.
Comment 6 Stefan Gohmann univentionstaff 2012-11-09 20:21:21 CET
Reicht zum Release.
Comment 7 Stefan Gohmann univentionstaff 2012-12-10 20:38:45 CET
Kein Blocker für das Release.
Comment 8 Moritz Muehlenhoff univentionstaff 2013-05-31 10:43:28 CEST
We will not ship a UCS 3.1-2 release; the next UCS release will be UCS 3.2.

As such, this bug is moved to the new target milestone.
Comment 9 Dirk Wiesenthal univentionstaff 2013-10-19 15:38:03 CEST
Ich habe die Doku insoweit angepasst, wie UCS 3.2 das App Center erweitert (z.B. automatische LDAP-Registrierung).

Soll http://wiki.univention.de/index.php?title=App_Center (komplett or teilweise) assimiliert werden? Oder bleibt das als erste Anlaufstelle erhalten und die developer reference richtet sich speziell nur an Entwickler?
Comment 10 Moritz Muehlenhoff univentionstaff 2013-10-21 09:12:24 CEST
(In reply to Dirk Wiesenthal from comment #9)
> Ich habe die Doku insoweit angepasst, wie UCS 3.2 das App Center erweitert
> (z.B. automatische LDAP-Registrierung).
> 
> Soll http://wiki.univention.de/index.php?title=App_Center (komplett or
> teilweise) assimiliert werden? Oder bleibt das als erste Anlaufstelle
> erhalten und die developer reference richtet sich speziell nur an Entwickler?

I think it would be best if the App Center documentation is fully integrated into the developers guide. Otherwise these wiki entries tend to gte out of sync over the time.
Comment 11 Dirk Wiesenthal univentionstaff 2013-10-21 16:05:39 CEST
Wiki Seite integriert
Comment 12 Stefan Gohmann univentionstaff 2013-11-06 07:22:05 CET
> It is recommended (and probably necessary) to provide at least one additional 
> package that arranges for deeper integration into Univention Corporate Server. 
> This package could be named univention-appname and have a dependency on the 
> core application (on dpkg level). Depending on whether the application wants to 
> extend the LDAP, another (independent) package needs to be provided, say, 
> univention-appname-master. It does not need to be installed on each system the 
> core application is installed but needs to stay installed even when the core 
> application is removed. Thus it should be as independent as possible from the 
> the core application (and univention-appname). 

I think it is no longer needed with UCS 3.2. My suggestion is to remove this block.


>  A minimal example along with some comments on the variables is attached:

It is not really minimal. It contains nearly every possible option. ;)

Please remove these sections / notes:
- 9.10. Best practices
- 9.11. Setup test app center
- This chapter is a draft and work in progress! Feedback is very much appreciated
Comment 13 Dirk Wiesenthal univentionstaff 2013-11-06 16:41:43 CET
(In reply to Stefan Gohmann from comment #12)
> > It is recommended (and probably necessary) to provide at least one additional 
> > package that arranges for deeper integration into Univention Corporate Server. 
> > This package could be named univention-appname and have a dependency on the 
> > core application (on dpkg level). Depending on whether the application wants to 
> > extend the LDAP, another (independent) package needs to be provided, say, 
> > univention-appname-master. It does not need to be installed on each system the 
> > core application is installed but needs to stay installed even when the core 
> > application is removed. Thus it should be as independent as possible from the 
> > the core application (and univention-appname). 
> 
> I think it is no longer needed with UCS 3.2. My suggestion is to remove this
> block.

Rephrased. Join Scripts can be included in main package. Join Scripts should use ucs_registerSchema.

> 
> 
> >  A minimal example along with some comments on the variables is attached:
> 
> It is not really minimal. It contains nearly every possible option. ;)

Removed "minimal"

> 
> Please remove these sections / notes:
> - 9.10. Best practices
> - 9.11. Setup test app center
> - This chapter is a draft and work in progress! Feedback is very much
> appreciated

Removed. 9.10 stripped down. app:ucs_registerLDAPExtension is referenced elsewhere.
Comment 14 Stefan Gohmann univentionstaff 2013-11-13 17:06:30 CET
OK
Comment 15 Stefan Gohmann univentionstaff 2013-11-19 06:43:58 CET
UCS 3.2 has been released:
 http://docs.univention.de/release-notes-3.2-en.html
 http://docs.univention.de/release-notes-3.2-de.html

If this error occurs again, please use "Clone This Bug".