docmenta en Openshift

Comment

Informática Linux Software

Buscando un software que permita hacer un manual de usuario para software, con exportación en HTML y PDF, me encontré con docmenta.org. Docmenta es un software libre desarrollado en JAVA, por lo tanto es plataforma web.

Entre otras cosas me gustó la posibilidad de la administración de usuarios, para que la edición de la ayuda o manual se haga de manera compartida.

Pero como indiqué está hecho en JAVA, y no cualquier hospedaje ofrece este tipo de servidores, y mucho menos gratis. Así que me puse a buscar y me encontré con OpenShift de RedHat.

Nunca incursioné en JAVA, así que tendría que ir paso a paso, hasta que logre hacerlo funcionar. No fue sencillo, me llevó varias horas, hacer y rehacer, pero finalmente valió la pena.

Así que describiré la manera en que lo hice, gracias a la ayuda de algún blog que en este momento no recuerdo. En mi PC uso Ubuntu, en Windows tendrán que adaptarse…

Para que sepan OpenShift ofrece varias plataformas en su hosting, por lo que hay que elegir entre las necesidades de cada uno. Y trabaja principalmente con git. OpenShift se vasa en “aplicaciones” y podemos crear hasta 3 de manera gratuita. Cada una que hagamos llevará un nombre y todas pertenecerán a nuestro namespace.

Aquí va el paso a paso:

  • Ir a docmenta.org y descargar la versión de war Package (aquí)
  • Descomprimir y reservar para más adelante.
  • Posicionate en la ruta de tu PC que quieras usar como repositorio, y ejecuta lo siguiente:
    rhc app create appname diy-0.1

    Esto crea la aplicación y el directorio local con nombre appname.

  • Luego debes posicionarte en este directorio.
    cd appname
  • Luego utilizamos git para descargar lo necesario:
    git remote add upstream -m master git://github.com/openshift-quickstart/openshift-tomcat-quickstart.git
    git pull -s recursive -X theirs upstream master
  • El paso siguiente es opcional, porque si quieres subir lo que tiene en webapps por defecto (trae ejemplos), lo ejecutas:
    git push
  • En caso contrarios borras todo y pegas el *.war que quieras usar:
    sudo rm -R diy/tomcat/webapps
  • Finalmente subes todos los cambios al hosting Openshift mediante git:
    git add -A .
    git commit -am "descripcion"
    git push
  • Luego de que termine, nuestro *.war estará desplegado y la aplicación lista para usar.

Aclaración: nuestra url para acceder a esta app será appname-namespace.rhcloud.com.
Si queremos que nuestra app se despliegue en la raíz, tenemos que renombar el .war antes de usarlo como ROOT.war.
En caso contrario, quedará como, por ejemplo, appname-namespace.rhcloud.com/docmenta/

Con respecto a docmenta, les cuento, que me gusta su manera de uso, está muy bien en general. Aunque tengo como crítica, un detalle en la exportación, la ToC no queda jerarquizada de una manera correcta desde mi punto de vista.

Deja un comentario