Cloudy plug-ins: Diferència entre les revisions

De Guifi.net - Wiki Català

(Primer commit)
m (Una petita introducció)
Línia 14: Línia 14:
  
 
Per tal de ser clar i donar alguns exemples al mateix temps, integrarem un servei bastant
 
Per tal de ser clar i donar alguns exemples al mateix temps, integrarem un servei bastant
simple mostrant alguns troços de codi pel camí
+
simple mostrant alguns troços de codi pel camí.
  
 
Per simplicitat farem servir Pastecat<ref name="Pastecat">(https://github.com/mvdan/pastecat)</ref>. És un bon candidat ja que:
 
Per simplicitat farem servir Pastecat<ref name="Pastecat">(https://github.com/mvdan/pastecat)</ref>. És un bon candidat ja que:
  
* És independent i no es federa ni es comunica amb altres nodes
+
* És independent i no es federa ni es comunica amb altres nodes
* Està fet en Go, és fàcil de distribuïr i instal·lar
+
* Està fet en Go, és fàcil de distribuïr i instal·lar
* No necessita fitxers de configuració
+
* No necessita fitxers de configuració
* No necessita gaires recursos
+
* No necessita gaires recursos
  
 
=== 1. Obtenint el binari ===
 
=== 1. Obtenint el binari ===

Revisió de 14:07, 24 març 2015

Què és un plug-in?

Cloudy és una distribució de Linux basada en Debian que dona als usuaris una interfície simple i còmode per gestionar diferents serveis que poden ser fets servir a través d'una xarxa comunitària; en el nostre cas, Guifi.

Al mateix temps, Cloudy ofereix una sèrie d'eines que permeten a un usuari afegir un servei del seu gust sense haver de tenir coneixements molt complexos sobre xarxes i informàtica en general. De manera automàtica, aquests serveis es publiquen mitjançant Avahi, i tothom que tingui Cloudy pot fer ús d'aquest servei.

Una altra manera d'anomenar aquests serveis que es poden posar i treure de forma senzilla és plug-in. Així doncs, entenem per plug-in un programa o software que un usuari vol afegir a la distribució i que pot ser gestionat de forma senzilla des de l'interfície web.

Afegir serveis a Cloudy

Una petita introducció

Aquesta guia t'ensenyarà el procés per afegir un nou servie a la distribució Cloudy.

Per tal de ser clar i donar alguns exemples al mateix temps, integrarem un servei bastant simple mostrant alguns troços de codi pel camí.

Per simplicitat farem servir Pastecat[1]. És un bon candidat ja que:

  • És independent i no es federa ni es comunica amb altres nodes
  • Està fet en Go, és fàcil de distribuïr i instal·lar
  • No necessita fitxers de configuració
  • No necessita gaires recursos

1. Obtenint el binari

El primer que hem d'investigar és com descarregar i instal·lar el binari a Cloudy. La majoria del software que podem trobat està per defecte en els paquets de Debian, però el Pastecat no hi és. Si es donés el cas que hi fós, tan sols hauriem d'executar la comanda apt-get install pastecat des de PHP.

Però com que aquest no és el cas, haurem de treure el binari d'algun altre lloc. Una opció és agafar el codi font i compilarl-lo nosaltres mateixos, però el problema d'això és que Cloudy necessitaría incloure moltes eines i llibreries per compil·lar, i aquest no és l'objectiu.

La millor opció si un paquet de Debian no està disponible en els repositoris, és descarregar els binaris des d'algun lloc segur. Podem fer servir el servei de "releases" de Github per això. Les dues opcions ens deixen amb un fitxer executable que hauriem de ser capaços de córrer directe sobre Cloudy.

En aquest cas en particular descarregarem els binaris des del repositori git amb la següent línia de comandes:

   wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386

Noteu que en aquest cas en concret estem descarregant una versió específica per un Linux amb arquitectura i386.

Fixeu-vos però, que tenir el servei en els paquets de Debian té moltes avantatges:

  • Les actualitzacions són simples i no necessiten feina extra des de Cloudy
  • El paquet està compilat per Debian d'una manera segura
  • Els fitxer de l'init.d ja venen per defecte
  • Els paquets de Debian solen contenir correccions

2. Provant-lo

Abans d'afegir un servei hauriem de configurar-lo i provar-lo directament nosaltres mateixos per veure com funciona i que realment funciona. També hem entendre quines opcions de configuració o línies de comandes necessitarem per fer ús d'aquest servei en particular i com el gestionarem un cop estigui funcionant.

3. Afegint el controlador

En web/plug/controllers tenim un fitxer PHP per cada servei anomenat controlador (o 'controller' en anglès). Aquest fitxer conté el codi que s'executarà quan es visiti la pàgina del nostre servei des de la interfície web de Cloudy.

Més informació

Més info si cal


Referències

  1. (https://github.com/mvdan/pastecat)


Enllaços externs

https://github.com/Clommunity/Doc/tree/master/plugins/pastecat

Eines de l'usuari