Az Atlassian Plugin SDK telepítéséhez remek leírást mellékelnek: https://developer.atlassian.com/display/DOCS/Set+up+the+Atlassian+Plugin+SDK+and+Build+a+Project
A telepítés nem igényel túl mély operációs rendszerbeli jártasságot, az Atlassian a főbb Linux terjesztésekhez is karbantart megfelelő repository állományokat, de például az általam használt openSUSE esetén se kell kétségbe esni, egy egyszerű tar.gz állomány letöltése és kicsomagolása után már egy működőképes SDK áll a rendelkezésünkre:
$ wget https://marketplace.atlassian.com/download/plugins/atlassian-plugin-sdk-tgz --2012-10-16 21:02:17-- https://marketplace.atlassian.com/download/plugins/atlassian-plugin-sdk-tgz marketplace.atlassian.com (marketplace.atlassian.com) feloldása... 63.246.22.212 Csatlakozás a következőhöz: marketplace.atlassian.com (marketplace.atlassian.com)[63.246.22.212]:443... kapcsolódva. HTTP kérés elküldve, várakozás válaszra... 302 Found Hely: https://maven.atlassian.com/content/groups/public/com/atlassian/amps/atlassian-plugin-sdk/4.0/atlassian-plugin-sdk-4.0.tar.gz [következik] --2012-10-16 21:02:18-- https://maven.atlassian.com/content/groups/public/com/atlassian/amps/atlassian-plugin-sdk/4.0/atlassian-plugin-sdk-4.0.tar.gz maven.atlassian.com (maven.atlassian.com) feloldása... 67.221.237.4 Csatlakozás a következőhöz: maven.atlassian.com (maven.atlassian.com)[67.221.237.4]:443... kapcsolódva. HTTP kérés elküldve, várakozás válaszra... 200 OK Hossz: 23192663 (22M) [application/x-gzip] Mentés ide: „atlassian-plugin-sdk-tgz" 100%[==================================================================================================================>] 23.192.663 1,67M/s idő 14s 2012-10-16 21:02:32 (1,62 MB/s) -- „atlassian-plugin-sdk-tgz" mentve [23192663/23192663] $ $ tar xzvf atlassian-plugin-sdk-tgz [...] $ rm atlassian-plugin-sdk-tgz $ cd atlassian-plugin-sdk-4.0/ $ bin/atlas-version ATLAS Version: 4.0 ATLAS Home: /home/work/atlassian-plugin-sdk-4.0 ATLAS Scripts: /home/work/atlassian-plugin-sdk-4.0/bin ATLAS Maven Home: /home/work/atlassian-plugin-sdk-4.0/apache-maven -------- Executing: /home/work/atlassian-plugin-sdk-4.0/apache-maven/bin/mvn --version Apache Maven 2.1.0 (r755702; 2009-03-18 20:10:27+0100) Java version: 1.6.0_24 Java home: /usr/lib64/jvm/java-1.6.0-openjdk-1.6.0/jre Default locale: hu_HU, platform encoding: UTF-8 OS name: "linux" version: "3.4.11-2.16-desktop" arch: "amd64" Family: "unix"
Az SDK csomagot ezzel sikeresen telepítettnek mondhatjuk, a kényelem okán még célszerű létrehozni egy ATLAS_HOME környezeti változót, illetve a PATH mögé beszúrni az SDK alatti bin könyvtárat, hogy ne kelljen állandóan hosszú elérési utakat begépelnünk (erre a célra a .profile állomány vége tökéletesen megfelel):
export ATLAS_HOME=/home/work/atlassian-plugin-sdk-4.0/ export PATH=$PATH:$ATLAS_HOME/bin/
Ezek után hozzunk létre egy munka könyvtárat, ahol az SDK által létrehozott projekteket fogjuk tartani:
$ cd /home/work/ $ mkdir atlassian-workspace $ cd atlassian-workspace $ pwd /home/work/atlassian-workspace
Az Atlassian SDK parancsai kivétel nélkül úgy kezdődnek, hogy atlas-, így egy kis parancssor által támogatott parancs-kiegészítés segítségével láthatjuk, hogy miket tudunk elvégezni:
$ atlas- atlas-clean atlas-create-crowd-plugin atlas-create-jira-plugin-module atlas-install-plugin atlas-run-standalone atlas-cli atlas-create-crowd-plugin-module atlas-create-plugin atlas-integration-test atlas-unit-test atlas-clover atlas-create-fecru-plugin atlas-create-refapp-plugin atlas-mvn atlas-update atlas-compile atlas-create-fecru-plugin-module atlas-create-refapp-plugin-module atlas-package atlas-version atlas-create-bamboo-plugin atlas-create-home-zip atlas-create-stash-plugin atlas-release atlas-create-bamboo-plugin-module atlas-create-jira4-plugin atlas-create-stash-plugin-module atlas-release-rollback atlas-create-confluence-plugin atlas-create-jira5-plugin atlas-debug atlas-ruin atlas-create-confluence-plugin-module atlas-create-jira-plugin atlas-help atlas-run
Indítsunk el egy fejlesztői Confluence példányt:
$ atlas-run-standalone --product confluence [...] [INFO] Starting confluence... (see log at /home/work/atlassian-workspace/amps-standalone/target/confluence-4.3.log) [...] [INFO] Starting confluence on the tomcat6x container on ports 1990 (http) and 37638 (rmi) [...] [INFO] [stalledLocalDeployer] Deploying [/home/work/atlassian-workspace/amps-standalone/target/confluence/confluence.war] to [/home/work/atlassian-workspace/amps-standalone/target/container/tomcat6x/cargo-confluence-home/webapps]... [INFO] [talledLocalContainer] Tomcat 6.x starting... [INFO] [talledLocalContainer] Tomcat 6.x started on port [1990] [INFO] confluence started successfully in 49s at http://linux-s54h.site:1990/confluence [INFO] Type Ctrl-D to shutdown gracefully [INFO] Type Ctrl-C to exit
Az Atlassian SDK (és az Atlassian termékek is mind) Maven alapokon működnek, így az első elindítás során le fogja tölteni a fél világot (ezek láthatóak a kihagyott log részleteknél), így mindenki megnyugodhat: az SDK nem 22MBájt, csak a funkcionális része, a tényleges SDK mérete jó párszor száz MBájt lesz az első futás után, az indítás helyén könnyen össze tud gyűlni néhány GBájtnyi adat (az éppen futtatott Atlassian termékek számától és tartalmától függően):
$ du --max-depth=1 -h 1,4G ./amps-standalone 1,4G .
A fentebb hivatkozott oldalt megtekintve egy Confluence oldal fogad minket, ahol az admin névvel és admin jelszóval be tudunk lépni:
A belépés után az előadás első felében már megismert Dashboard látható, annyi különbséggel, hogy ez a Confluence példány egy demonstrációs alappal van feltöltve, illetve az alsó sávban jól láthatóan fejlesztési célokat szolgál (és 5 felhasználóra van limitálva):
A demonstrációs területre kattintás után látható a wiki tartalom: