La distribution nuxeo

yakafokon

« 

— Pouvez-vous ?
— Je le peux.
— Vous pouvez vraiment le faire ?
— Oui…
— Iel peut le faire ! Alors on l’applaudit très fort !
— Pour ce qui nous concerne, n’applaudissez pas trop vite… Attendez d’avoir lu le rapport.  »

PackWar

nuxeoctl pack /tmp/nuxeo-war.zip

PackWar.java
…
package org.nuxeo.runtime.deployment.preprocessor;
…
/**
 * Packs a Nuxeo Tomcat instance into a WAR file inside a ZIP.
 */
public class PackWar {
…
          

Intégration Continue

Gitlab

• historique : git
• suivi des itérations : issues, milestones
• documentations (équipes de dev) : wiki
• intégration continue : build, test

  • apt-get install gitlab-ci-multi-runner docker.io

    , .gitlab-ci.yml
• déploiement continu : deploy, environment
  

  parallel-ssh -l root -h servers.list -it0 -- DEBIAN_FRONTEND=noninteractive apt-get -y "/…/….deb"

Déploiement Continu

org.nuxeo.launcher.config.ConfigurationGenerator dispose d'une main
→ on peut l'appeler depuis un postinst et regénérer les configurations depuis les templates et le nuxeo.conf

text-template.js
var ConfigurationGenerator = Java.type("org.nuxeo.launcher.config.ConfigurationGenerator")
java.lang.System.setProperty(ConfigurationGenerator.NUXEO_CONF, "/etc/nuxeo.conf")
var confGen = new ConfigurationGenerator()
var TextTemplate = Java.type("org.nuxeo.common.utils.TextTemplate")
var templateParser = new TextTemplate(confGen.userConfig)
templateParser.processText(java.lang.System.in, java.lang.System.out)
          

postinst
__update_tomcat_server_xml() {
	echo "rebuild $tomcat's server.xml and context"
	# rebuild tomcat's configuration
	$package_dir/bin/text-template.js \
		"$package_dir/templates/common-base/conf/server.xml.nxftl" \
		"/etc/$tomcat/server.nuxeo.xml" \
		"$package_dir/templates/common-base/conf/Catalina/localhost/ROOT.xml" \
		"/etc/$tomcat/Catalina/localhost/ROOT.xml" \
		"$package_dir/templates/common-base/conf/Catalina/localhost/nuxeo.xml.nxftl" \
		"/etc/$tomcat/Catalina/localhost/nuxeo.xml"
    displace_link /etc/$tomcat/server .xml
}
          

postinst
## check tomcat uid/gid is coherent across NFS (cluster)
__assert_cluster_grade_tomcat_uid_gid(){
  repository_clustering="$($package_dir/bin/text-template.js <<< '${repository.clustering.enabled}')"
  repository_binary_store="$($package_dir/bin/text-template.js <<< '${repository.binary.store}')"
  if [ "true" = "${repository_clustering}" ]
  then
    echo 'check binary store'
    ## check repository_binary_store is on NFS if repository_clustering=true
    if [ ! -e "$repository_binary_store" \
       -o "xnfs" != "x$(df -T "$repository_binary_store" | awk 'NR==2 {print $2}')" ]
    then
      db_input critical [[artifactId]]/cluster_not_nfs || true
      db_go
      exit 1
    fi
    if [ -n "$repository_binary_store" -a -d "$repository_binary_store" \
       -a -e "$repository_binary_store/config.xml" ]
    then
      ## check repository_binary_store's owner uid/gid
      BS_IDs="$(stat -c '%u/%g' "$repository_binary_store/config.xml")"
      TC_IDs="$(id -u $tomcat)/$(id -g $tomcat)"
      if [ "$TC_IDs" != "$BS_IDs" ]
      then
        db_input critical [[artifactId]]/cluster_ids_mismatch || true
          

Bundles OSGi dans Nuxeo

digraph NXPlatform {
  bgcolor=transparent
  id="\G"
  fontsize=11
  node [ id="\G-\N", shape=rect, style=filled, fillcolor=white, fontsize=10 ]
  edge [ id="\G-\E", fontsize=10 ]

  subgraph cluster_bundle {
    style=filled; fillcolor="#dcf0ff";
    label="fr.univ.groupId : artefactId : version:.jar (pom.xml)";
    labelloc=b;
  manifest [ label="META-INF/MANIFEST.MF\lBundle-SymbolicName: fr.univ.mon.bundle" ];
  
  { rank=same
  contrib1 [ label="OSGI-INF/une-contrib.xml\l<component name=“fr.univ.contrib”>" ];
  contribFRWK [ label="OSGI-INF/un-framework.xml\l<component name=“my.target”>" ];
  }

  manifest -> contrib1 [sametail=C, taillabel="Nuxeo-Component:"];
  manifest -> contribFRWK [sametail=C];

  { rank=same
  extension1 [ label="<extension\l  target=“my.target”\l  point=“xtpoint”>"];
  xtpointFRWK [ label="<extension-point\l   name=“xtpoint”>\l" ];
  }
  extension2 [ label="<extension\l  target=“…”\l  point=“…”>"];

  serviceSRV [ label="<service><provide\l    interface=“fr.univ.my.ServiceAPI” />\l"];
  implFROB [ label="<implementation\l    class=“fr.univ.my.ServiceImpl” />\l"];
  objectFROB [ label="<object class=“fr.univ.my.Descriptor”>" ];

  { rank=same
  DescriptorIMPL [ label="@XObject(“truc”)\lclass fr.univ.my.Descriptor\l{\l  @XNode(“@name”)\l  private String id;\l}\l" ]
  ServiceIMPL [ label="class fr.univ.my.ServiceImpl\l  implements fr.univ.my.ServiceAPI {\l    public void registerContribution(…)\l    { … }\l}\l" ];
  XPcontrib [ label="<truc name=“bob”>\l  <elem>val</elem>\l</truc>\l" ]
  }

  { edge [arrowtail=diamond, dir=back];
  contrib1 -> extension1 -> XPcontrib;
  contrib1 -> extension2 [minlen=2];
  contribFRWK -> serviceSRV;
  contribFRWK -> implFROB [minlen=2];
  contribFRWK -> xtpointFRWK -> objectFROB;
  }

  objectFROB -> DescriptorIMPL [dir=none];
  implFROB   -> ServiceIMPL [dir=none];
  serviceSRV-> ServiceIMPL [dir=back,arrowtail=onormal,style=dashed];

  deploymentDPL [ label="OSGI-INF/deployment-fragment.xml"];
  jsfimgDPL [ label="web/nuxeo.war/incl/….xhtml\lweb/nuxeo.war/img/icon.png\l" ] 
  msgDPL [ label="OSGI-INF/\l  l10n/\l    messages_fr_FR.properties\l" ] 

  deploymentDPL -> jsfimgDPL;
  deploymentDPL -> msgDPL [minlen=2];

  propSEAM [label="seam.properties"];
  beanSEAM [ label="@Name(“monBean”)\lpublic class MonBean {\l  @In protected transient\l    CoreSession docMgr;\l}\l" ];

  msgDPL -> propSEAM -> beanSEAM [style=invis];
  jsfimgDPL -> beanSEAM [color=gray];
  }

  {
    node [ style=none, label="", width=0, height=0]
    edge [ arrowhead=odot, constraint=false]
    publicXPFRWK [shape=none];
    publicSRV [shape=none];
    xtpointFRWK -> publicXPFRWK
    serviceSRV -> publicSRV;
  }
  newrank=true;
  { rank=same xtpointFRWK publicXPFRWK }
  { rank=same serviceSRV publicSRV }

  { edge [arrowhead=vee, style=dashed, constraint=false];
  contrib1 -> contribFRWK [color=red,label="<require>my.target</require>"];
  extension1 -> publicXPFRWK    [color=green];
  publicXPFRWK   -> implFROB    [color=blue];
  XPcontrib  -> DescriptorIMPL  [color=green];
  DescriptorIMPL -> ServiceIMPL [color=blue];
  }

}
          

code JAVA intégré

META-INF/MANIFEST.MF
Manifest-Version: 1.0
Bundle-Vendor: UdS
Bundle-Name: derec
Bundle-SymbolicName: fr.unistra.derec
Bundle-Description: Démat Recrut EC
Bundle-Version: 2.0.0-SNAPSHOT
Bundle-ManifestVersion: 2
Nuxeo-Component: OSGI-INF/listeners-contrib.xml
            

OSGI-INF/listeners-contrib.xml
<?xml version="1.0"?>

  <extension
    target="org.nuxeo.ecm.core.event.EventServiceComponent"
    point="listener">
    <listener name="applicationremovedlistener" async="false" postCommit="true"
              class="fr.unistra.derec.event.ApplicationRemovedListener" order="100">
      aboutToRemove
    </listener>
  </extension>

            

fr/unistra/derec/event/ApplicationRemovedListener.java
package fr.unistra.derec.event;
public class ApplicationRemovedListener implements EventListener {
  public void handleEvent(Event event) {
    DocumentModel doc = ((DocumentEventContext) event.getContext()).getSourceDocument();
    if (! "Application".equals(doc.getType())) return;
    String candidateId = (String) doc.getPropertyValue("application:candidate_id");
    String jobId =       (String) doc.getPropertyValue("application:job_id");
    UserManager userMgr = Framework.getLocalService(UserManager.class);
    userMgr.deleteUser( "c" + candidateId + "-" + jobId );
  }
}