I’ve been doing deployment using Git for a while by now. But I find Capistrano more flexible and reliable. Since Capistrano is intended to be used with Ruby on Rails it doesn’t work with other platforms “out-of-the-box“. But magic can still occur with a few lines of code.

Below you’ll a “step-by-step” tutorial on how the get started using Capistrano for easier deployment. The whole idea for this post came in mind during a Capistrano setup for a Codeigniter application I did recently. But I don’t see why this deployment process wouldn’t be applicable on any other platform or framework.

This tutorial assumes you already got your code hosted using either SVN or Git. You preferaly have setup public ssh keys between your computer and the server you’re deploying to. You’re using the same directory structure as below for your applications on your server (feel free to change the Capfile in order to match your existing structure).

/var/www/example.com
/var/www/example.com/www.example.com
/var/www/example.com/www.example.com/logs
/var/www/example.com/www.example.com/public

Start of by installing Capistrano on your computer. Capistrano is distributed as a Ruby gem.

$ sudo gem install capistrano

Next up clone my default Capfile (Capistrano config file) using cURL. Or use the Gist below.

$ curl "http://gist.github.com/raw/353124/ceda1eccacee7604d7180b23ff20cb618cb760af/capfile.rb" > Capfile

There are some variabels you need to change in order to make this Capfile work with your setup. Basically look through all lines that begins with “set” and change the corresponding value. Also make sure to change the server domain on line 10.

A typical Capistrano deployment is loaded with different kind of tasks. Since Capistrano is awesome it allows you to setup own tasks and even overwrite existing tasks.

As mentioned earlier Capistrano was invented with Ruby on Rails in mind, therefor we need to overwrite a few Rails specific tasks (migrate, restart, start). These default tasks are probably not compatible with your application. But feel free to rewrite them if needed.

As you might noticed by now the task “copy_config” inside Capfile isn’t a default task. My Codeigniter applications usually include some setup specific config files that shouldn’t be included in the repository by obvious reasons. For instance a config file including all necessary MySQL credentials. Therefor these files needs to be setup and edited manually in order to get the application running. But there’s one problem using this method with Capistrano.

Everytime you deploy using Capistrano a fresh copy of your latest application is being cloned/checkout from the repository and stored inside a new folder on the server. Since Capistrano doesn’t proceed from the previous deployed release all files that isn’t included in the repository will not be moved to the new deployed release folder. But no worries! Since Capistrano allows us to hook up our own tasks to specific events during deployment we can solve this problem with ease.

The task namned “copy_config” is being executed right after the “symlink” task. Right after the new release directory has been created and linked to the current directory. Since all my necessary config files are included in the “.gitignore” file we can use that as a reference and simply check if the file exists in the previous release folder. If so simply move the file to the newly created release folder. Capistrano provides some nifty variabels such as “previous_release” and “latest_release” to make this operation easier.

Any other needed operation to get your application up and running should probably be executed after the “symlink” task.

Once your Capfile is done it’s time to run a initial setup deploy. Start of by running the following command.

$ cap deploy:setup

You should end up with a similar directory structure on your server.

/var/www/example.com/www.example.com/public/releases
/var/www/example.com/www.example.com/public/shared
/var/www/example.com/www.example.com/public/shared/log
/var/www/example.com/www.example.com/public/shared/pids
/var/www/example.com/www.example.com/public/shared/system

It’s finally time to perform a first initial (cold) deploy of your application to your server.

$ cap deploy:cold

Congratulations! You just performed your first deploy using Capistrano. For future deploys the cold task isn’t necessary. Simply execute the command below.

$ cap deploy

Easy enough don’t you think?

This post should give you a brief idea of the Capistrano workflow. And show how you can hook up your own tasks in order to get your application up and running. I can’t guarantee that this method can be applicable on your application. As the title states “… almost anything“.

Interested in learning more about Capistrano? Here’s a few posts that I stumbled across and found interesting during research for this post.

Photo credit: heyskinny

För dig som inte är bekant med Hack Day konceptet går det kort och gott ut på att skapa något under 24 intensiva timmar. Den faktiska slutprodukten är inte det viktigaste utan det är mer fokus på att faktiskt åstadkomma något.

Bonnier Hack Day var faktiskt min tredje Hack Day i ordningen. Enda skillnaden denna var att jag inte närvarade som privatperson utan representerade Mobilab tillsammans med Herman Olsson, Gunnar Johansson och Morris Packer.

Vårt projekt med arbetsnamnet “tvättmaskinen” är ganska tråkigt för att vara ett Hack Day projekt men något som vi intern kommer ha stor nytta av. Hela idén grundar sig i att vi av olika skäl inte kan hämta innehåll direkt Expressens API från klienten (t ex. en iPhone applikation). Därav byggde vi ett mellanlager som hämtar innehåll från Expressen och lagrar det slutligen på Amazons S3 plattform. På så sätt kan vi på våra kommande sajter och applikationer komma åt det innehåll som efterfrågas utan att gå direkt mot Expressens API. En annan fördel med att lagra innehållet hos Amazon S3 är att Expressen kan gå ner, vår “tvättmaskin” kan gå ner men alla sajter och applikationer kommer fortfarande ha tillgång till det senaste innehållet eftersom Amazon S3 är så stabilt det bara kan bli.

Efter 24 intensiva timmar fick alla chansen att presentera sina projekt i sann Hack Day anda. Bland publiken fanns även en jury bestående av massa kloka huvuden. Denna jury korade sedan en vinnare som inte var någon mindre än Sydsvenskans Citypedia projekt med följande motivering.

The jury … particularly liked the way in which team Sydsvenskan used new and vastly different sources/API:s to provide more accurate and extensive reviews.

Nedan finns även en lista över mina favorit projekt utan någon specifik rangordning.

• repr.is
  En tjänst som aggregerar alla s.k. play-tjänster och gör dem sökbara under ett och samma tak. En klockren idé som verkligen fyller ett behov som jag personlig har känt av. Jag hoppas verkligen att denna tjänst fortsätts utvecklas. Utvecklat av Marcus Lindén och Per Åström, båda ifrån TV4.
• linkr
  Att förena det digitala med det analoga har gång på gång visat sig vara ett vinnande Hack Day koncept. Linkr är heller inget undantag. Vad denna röda låda gör är att visa antalet klick som besökarna genererat de senaste fem minuterna från ett visst antal fördefinierade sajter. Det hela kompletteras med en indikator som visar om antalet klick har ökat eller minskat gentemot den tidigare fem minuters perioden. Syftet är att konkretisera och öka förståelsen kring statistiken som finns tillgänglig hos främst redaktionerna som ansvarar för innehållet på sajterna. Utvecklat av Per Åström och David Hall.
• whereitshot
  Google Maps i kombination med s.k. heatmaps för att presentera data är något som på senaste tiden har intresserat mig. Vad whereitshot gör är att visa vart “tweets” innehållandes en viss sökterm är mest förekommande rent geografiskt. Det hela visar visserligen bara en bråkdel av alla “tweets” eftersom denna idé bygger på att alla “tweets” är geotaggade med faktiska koordinater. Hur som helst är hela genomförande väldigt snyggt och genomtänkt. Utvecklat av Anders Cserkuti och David Andersson, både ifrån Adlibris.
• Pictoriala
  Utvecklat av Hack Day veteranerna Henrik Berggren och David Kjelkerud, båda ifrån Doberman. Ett oerhört grafiskt tilltalande nyhetsflöde i form av bilder är vad jag skulle kalla Pictoriala för.

Så här i efterhand kan jag konstatera att detta var ännu en oerhört lyckad Hack Day. Det är kul att se att detta koncept börjar dyka upp mer och mer här hemma i Sverige. Återigen ett stort tack till alla som gjorde dessa 24 timmar till något helt fantastikt. Jag ser med glädje fram emot nästa Bonnier Hack Day!

Bilderna tillhörande detta inlägg är lånade ifrån Bonnier R&D.

Jag tog mig tiden att läsa igenom loggen med ändringar. Nedan följer en lista över mina fem favoriter.

1. Smidigare konstruktion av element
   Vid konstruktion av ett nytt element kan du nu skicka med ett objekt innehållandes egenskaper.

2. Enklare attribut manipulation
   Funktioner för att manipulera element så som .css(), .attr(), .val() och .html() kan nu ta en funktion som andra parameter. I funktionen kan du enkelt komma åt det befintliga attributets värde.

3. Unik easing metod per egenskap
   Det är nu möjligt att definiera en easing metod för enskilda egenskaper.

4. Äntligen en riktig delay funktion
   Nu är du inte längre tvungen att “fulhacka” för att skapa en delay effekt.

5. Ajax anrop tar hänsyn till Last-Modified headern
   Tidigare har alla ajax funktioner ignorerat Last-Modified headern. I syfte att ignorera eventuellt cache från webbläsaren. Genom att sätta ifModified till true tvingas jQuery att läsa från webbläsarens cache (förutsagt att något finns).

Om du är sugen på att grotta dig ännu djupare finns en bra redovisning av de nya funktionerna och förbättringarna på kampanjsajten 14 Days of jQuery.

I sedvanlig ordning tillhandahåller Google jQuery 1.4 (minifierad och gzippad) på deras supersnabba CDN.

Bilden tillhörande detta inlägg är lånad ifrån Eric Miraglia.

Därav hörde jag mig för om jag fick “forka” plugin:en och modifiera den utefter mina behov. Givetvis vart svaret ja.

Good Old Email Templates är alltså en plugin till WordPress för att skapa och administrera email-mallar. Mallarna kan innehålla ett flertal variabler som kan ersättas med egna värden. Detta är framför allt smidigt när man ska göra automatiska mailutskick till ett flertal användare.

Koden har fått sig en rejäl översyn och större delar har skrivit om av mig. Givetvis är plugin:en släppt helt i det fria. Var så god att ladda ner plugin:en från GitHub eller varför inte skapa en egen fork?

Idéen till projektet mipi.se spånades redan fram på konferensen Reboot av mig och Morris Packer. Grundidéen var helt enkelt att kunna skapa en frågeställning för att sedan skicka ut den till en så stor publik som möjligt. Med andra ord frågan är fri.

Under mina 24 timmar skapade jag ett webbaserat gränssnitt för att skapa frågor och se resultatet som uppdateras i realtid. Användningsområdena är redan så här initialt många. Tänk t. ex. om du anordnar en konferens och vill ha din deltagares svar på en viss fråga. Skapa frågan och visa resultatet en storskärm medhjälp av en projektor. Deltagarna kommer på så sätt kunna följa utvecklingen i realtid.

Det hela byggdes i ramverket Codeigniter som jag verkligen har fattat tycke för den senaste tiden. Plus en hel del JavaScript med jQuery som grund.

Framtiden för detta projekt ser ljus ut. Appcorn har sedan en tid tillbaka tagit fram en “proof of concept” iPhone applikation som använder sig av Push-protokollet för att skicka ut frågor.

Gillar mipi.se får du gärna rösta på oss. Eller läs mer om bakgrunden till detta projekt.

För er som inte känner till Dropbox så är det en programvara som håller dina filer i synk mellan olika datorer. Tjänsten kompletteras med ett webbgränssnitt samt en nyligen släppt iPhone applikation. Allt du behöver göra för att komma igång är att installera Dropbox på valfri dator (Mac, Windows eller Linux). Att sedan dela med sig av filer och mappar har aldrig varit enklare.

Git å andra sidan är ett versionshanteringssystem utvecklat av ingen mindre än Linus Torvalds. Systemet har ökat sin marknadsandel markant den senaste tiden. Fler och fler open source plattformar och andra tjänster har valt Git i kombination med GitHub framför konkurrenterna SVN och CVS.

Att börja använda Git tillsammans med Dropbox är bara enkla 5 steg ifrån. Så här gör du.

1. Givetvis krävs ett Dropbox konto. Om du inte redan har ett så kan du skaffa ett alldeles gratis hos Dropbox.
2. För enkelhetens skull väljer vi att kalla vårt repository “projekt” i detta exempel. Börja med att skapa mappen “projekt”, navigera ditt och initialisera Git.

   $ mkdir projekt
   $ cd projekt
   $ git init

3. Klona en “rå” kopia av repot till valfri mapp i din Dropbox.

   $ git clone --bare . ~/Dropbox/git/projekt.git

4. Lägg slutligen till det “råa” repot som ett externt repository. Vi väljer att kalla det för “dropbox“.

   $ git remote add dropbox ~/Dropbox/git/projekt.git

5. För att pröva allt står rätt till kan vi skapa en första commit och pusha uppdateringen till vårt repository i Dropboxen. Vi väljer att lägga till en tom gitignore fil.

   $ touch .gitignore
   $ git add .
   $ git commit -m "Initial commit."
   $ git push dropbox master

Om du vill dela repot med en kollega eller vän är det så enkelt som att dela ut en mapp via Dropbox. Personen ifråga kan sedan klona repot och utföra lokala ändringar som sedan pushas till repot i Dropboxen.

$ git clone ~/Dropbox/git/projekt.git
$ cd projekt
$ git remote add dropbox ~/Dropbox/git/projekt.git

Notera att steg två ovan är valfritt. Per automatik kommer repot i Dropboxen döpas till “origin“. Dock kan du som exemplet påvisar döpa om det till något annat.

För att hålla din lokala kopia uppdaterad med de senaste ändringarna som finns i Dropboxen utför du följande kommando.

$ git pull dropbox master

För att göra denna process lite enklare så har jag satt ihop ett shellskript som skapar ett nytt lokalt Git repository och ett i Dropboxen. Se installationsprocess nedan. Notera att du måste ändra variabeln “DROPBOX” i skriptet på rad 3 till den absoluta sökvägen till mappen i Dropboxen där du vill spara alla Git repositories.

$ curl -O "http://gist.github.com/raw/212810/36e6320523db68618e108c4fb1add06eefeec485/git-init-dropbox"
$ chmod u+x git-init-dropbox
$ sudo mv git-init-dropbox /usr/local/bin

Nedan finns ett exempel på hur man skapar ett nytt repository medhjälp av git-init-dropbox (shellskriptet).

$ mkdir projekt
$ cd projekt
$ git init-dropbox

Inspirationen till detta inlägg är hämtat ifrån Matt Longs bloggpost Version Control Makes You A Better Programmer.

Beskrivningen på jQuerys officiella hemsida fångar det jag försöker beskriva.

jQuery is a fast and concise JavaScript Library that simplifies HTML document traversing, event handling, animating, and Ajax interactions for rapid web development. jQuery is designed to change the way that you write JavaScript.

Även jag har dragit mitt strå till stacken genom att dela med mig av några små plugins som jag har utvecklat på egenhand.

jContact

En plugin som kan används för att presentera kontaktinfo eller annan viktig information på ett snyggt sätt.

Exempel #1
Exempel #2
Ladda ner jContact

jFields

Låter dig ge textfält (inputs och textareas) standardvärden som beskriver vad fältet ska innehålla. Detta standardvärde försvinner så fort fältet markeras eller blir aktivt. Denna plugin är användbar om du inte vill använda dig av labels p.g.a. platsbrist eller av estetiska skäl.

Exempel #1
Ladda ner jFields

jCountUp

Tillåter dig att räkna upp ett elements värde på ett snyggt sätt. Kan vara användbart när man bygger en årtals-navigation eller liknande. Det finns även gott om inställningar så som t ex. hastighet, värde och en callback.

Exempel #1
Exempel #2
Ladda ner jCountUp

jPreloader

Ersätter submit-knappen med en valfri preloader när en AJAX request utförs. I dagsläget fungerar endast denna plugin med formulär och används tillfördel med jForm.

Exempel #1
Ladda ner jPreloader

SimpleBlock

Till ett kundjobb behövde jag blockera (göra dem “oklickbara“) några element under en bestämd tid. Det finns redan en del plugins som löser detta. Dock kändes de allt för tunga i detta fall. Därav skrev jag ihop SimpleBlock som låter dig blockera ett eller flera element under en given tid.

Exempel #1
Ladda ner SimpleBlock

Alla plugins finns tillgängliga på GitHub och är koden är helt och hållet fri. Vilket i praktiken innebär att du har tillåtelse att använda dem och modifiera dem bäst du vill. Har du hittat en bugg eller sitter på lite feedback? Lämna då gärna en kommentar.

Om du själv är sugen på att börja skriva riktiga plugins till jQuery rekommenderar jag denna guide från Nettuts och en från SitePoint.

Tidigare i år skrev jag ihop en API wrapper för SoundCloud i PHP. Idag kan jag med glädje meddela att denna wrapper har utökats med stöd för det nya OAuth protokollet.

Öppen autentisering är hetare än någonsin. Bland de främsta i ledet står det nya protokollet OAuth, som ur ett perspektiv gör det möjligt för dig som användare att logga in och komma åt t ex. ditt SoundCloud-konto från vilken sajt som helst (förutsagt att stöd för OAuth finns). Fördelarna är många, inte minst p.g.a. att vi slipper komma ihåg en uppsjö av användarnamn och lösenord. Ett praktiskt exempel är Twitter som tack vare sitt API med stöd för OAuth har lyckats skapa ett helt ny flora med tredjepartsutvecklade tjänster.

För er som inte känner till SoundCloud sen tidigare så kan jag berätta att det är fantastik tjänst utvecklad av musiker för musiker. Flickr kretsar kring bilder, Youtube kring video och SoundCloud kring musik. Tjänsten är utvecklad av två svenska smartskallar vid namn Alexander Ljung och Eric Wahlforss.

Att SoundCloud är en succé råder det inget tvivel om. Med drygt 300 000 användare och 2,5 miljoner euro i riskkapital ser framtiden oerhört ljus ut. Om du vill läsa mer om deras framgångsresa rekommenderar jag ArcticStartups bloggpost från i våras.

Timingen för releasen av denna wrapper kunde inte ha varit bättre. Ikväll inleds nämlingen Music Hack Day i Berlin där en massa musiker och utvecklare samlas under samma tak för att skapa musikrelaterade tjänster och program. Jag hoppas att min wrapper kan komma till användning!

API wrappern finns tillgänglig på GitHub samt ett exempel på hur du kommer igång. Jag satte även ihop en liten demo applikation som finns att pröva på soundcloud.qvister.se. SoundCloud själva har även skrivit om wrappern deras egna blogg.

Uppdatering: i ett nyligen publicerat inlägg hos självaste TechCrunch länkas det till wrappern min!

Denna funktion tar flera argument, en utav dem är “callback” som låter dig koppla en egen funktion som påkallas så fort en kommentar ska visas. På så sätt kan du själv bestämma vad som ska visas och inte visas. Personligen vart jag lite inspirerad av Disqus listning av kommentarer och valde även att formatera datumet och tiden då kommentaren postades på samma sätt som Twitter. Funktionen jag använder mig av heter niceTime och hittas borta hos Manas Tungare. Givetvis har skribentens uppgifter formaterats enligt hCard standarden.

Om du själv vill ta kontroll över listningen av kommentarerna på din blogg rekommenderar jag dig att läsa igenom dokumentationen hos WordPress.

Thumbnailen tillhörande detta inlägg är lånad ifrån thehutch.

Ett RSS-flöde är dock inte det ultimata sättet att hålla koll på alla namnsdagar. Varför inte låta informationen komma till en istället? Med detta i åtanke skrev jag ihop en enkel twitterbot som varje dag berättar om vem eller vilka som har namnsdag. Om du följer namnsdag på twitter gratulerar den även dig på din egen namnsdag.

För den tekniskt intresserade är det ett skript skrivet i PHP som parse:ar RSS-flödet från dagensnamnsdag.nu och twittrar sedan via twitter egna API. Skriptet körs i en crontab som utförs 01:00 varje dag.

Så vill du bli kvitt alla pinsamma situationer där du har glömt bort eller helt och hållet missat dina nära och käras namnsdagar? Följ då namnsdag på twitter!

Idéen grundade sig i frågan “Hur svårt kan det vara att bygga en URL-förkortare?” och inte minst p.g.a. avsaknaden av en bra svensk URL-förkortare. En helg senare hade jag en färdig applikation och domänen korta.nu visade sig vara ledig. Idag används tjänsten ganska flitigt, inte minst på Twitter.

Tjänsten kompletteras med en bookmarklet som gör det oerhört enkelt att förkorta länkar med en knapptryckning och en Mac OS X Dashboard widget.