robkorv.nl

Github page lokaal ontwikkelen

Sat, 18 Jul 2015 15:57:23 +0000

Met de volgende instructies kan je lokaal Github pages ontwikkelen. De instructies zorgen ervoor dat je lokaal dezelfde setup hebt, als Github gebruikt voor het genereren van pages.

Ik ga ervan uit dat ruby via rbenv beschikbaar is zoals bij Een ruby omgeving per project in Ubuntu is beschreven.

Let’s go

Maak een dir aan, bijvoorbeeld my-gh-page en zorg dat je in de dir staat voordat je de commando’s uitvoert.

Bezoek GitHub Pages Dependency versions en zorg dat je tenminste de ruby versie hebt die wordt genoemd. In dit voorbeeld wordt versie 2.2.2 geïnstalleerd.

installeer ruby en bundler met de volgende commando’s:

# ruby installeren
rbenv install 2.2.2
# bundler installeren
gem install bundler

maak een Gemfile bestand aan met de volgende inhoud:

source 'https://rubygems.org'

require 'json'
require 'open-uri'
versions = JSON.parse(open('https://pages.github.com/versions.json').read)

gem 'github-pages', versions['github-pages']

installeer vervolgens github-pages met bundle install --binstubs .bundle/bin.
creëer een standaard template met jekyll new ..
Bekijk de website met jekyll serve.

Lees meer over het maken van websites met Jekyll in de documentatie.

lees meer

Using Jekyll with Pages
GitHub Pages

Een uitgaande mailserver opzetten in Ubuntu

Tue, 30 Sep 2014 16:14:00 +0000

Web applicaties vesturen vaak mailtjes. Denk aan het bevestigen van een account, wachtwoord opvragen, o.i.d. Hiervoor is geen volwaardige mailserver nodig, een server die enkelt mail verstuurd is voldoende. De volgende instructies zorgen ervoor dat zo’n server wordt opgezet.

Mailserver installeren en configureren

In plaats van apt-get wordt er tasksel gebruikt. Tasksel installeerd niet alleen packages, hij stelt ze ook voor je in. Tasksel toond waar nodig een wizard om de juiste instellingen per situatie te laden. Tasksel zal voor de mailserver vragen voor welke situatie deze wordt gebruikt

# mailserver via tasksel installeren
sudo tasksel install mail-server

Kies tijdens de installatie voor Internetsite. Vervolg de wizard.

Let wel op dat als de mailserver een bepaald domein vertegenwoordigd dit goed wordt ingesteld. Als dit niet goed wordt ingesteld zullen de mails altijd in de spambox van de ontvanger terecht komen. Voor een locale ontwikkel server kan je de al aanwezige instellingen gebruiken, kijk dan wel in je spambox als je mail verwacht.

Maak een self-signed certificate aan, de mailserver wordt niet extern benaderd maar een certificaat is wel nodig voor de basis instelling.

Testen

Stuur vervolgens een test mailtje via de terminal, vergeet niet het email adres te wijzigen.

echo "Dit is de inhoud van een testmail" | mail -s "Dit is het onderwerp van de testmail" "aan@mailadres"

Kijk in je spambox!

lees meer

Handleiding Ubuntu-server: Email Services

301 Redirect met Nginx in Ubuntu

Sun, 31 Aug 2014 21:18:40 +0000

Een 301 is een HTTP status code waarmee je aan de client doorgeeft dat het bezochte adres permanent is verhuist naar een ander adres. Dit is ook de manier om aan zoekmachines door te geven dat een url is verplaatst. Handig bij domein wijzigingen en url aanpassingen dus.

De volgend instructies zijn geschreven voor nginx/1.6.0. Lees Nginx installeren voor instructies om de meest recente Nginx te installeren in Ubuntu.

Redirecten met Nginx gaat via een virtualhost.

Nginx redirect virtual host

Als voorbeeld, zal de volgende instructies http://btstrp.localtest.me redirecten naar http://bootstrap.localtest.me. Zie Nginx http virtual host voor de vhost waarnaartoe geredirect wordt.

Maak /etc/nginx/sites-available/btstrp-redirect aan met de volgende inhoud.

server {
    server_name btstrp.localtest.me;
    return 301 http://bootstrap.localtest.me$request_uri;
}

# symlink de vhost naar sites-enabled
sudo ln -s /etc/nginx/sites-available/btstrp-redirect /etc/nginx/sites-enabled/
# herstart nginx
sudo service nginx restart

Open http://btstrp.localtest.me en zie dat deze geredirect wordt. Het hele url wordt geredirect, http://btstrp.localtest.me/examples/carousel/ zal dezelfde locatie openen op bootstrap.localtest.me.

lees meer

HTTP 301 - Wikipedia, the free encyclopedia
Nginx http rewrite module - return

Nginx met SPDY in Ubuntu

Sun, 17 Aug 2014 20:46:23 +0000

SPDY is een verbetering van het HTTPS protocol en is zo’n 40% sneller. Encryptie is vereist voor SPDY, het is daarom alleen in productie te gebruiken als er een geauthoriseerd SSL/TLS sleutel aanwezig is.

SPDY is nog experimenteel, wat niet inhoud dat het niet productie gereed is. Experimenteel houdt voor SPDY in dat niet elke browser er mee overweg kan. SPDY is een laag boven op HTTPS, een browser zonder SPDY ondersteuning zal de site via traditionele HTTPS laden. SPDY wordt overigens in elke moderne browser ondersteund met uitzondering van Internet Explorer. Google, Facebook, YouTube en Twitter zijn enkele grote sites die met SPDY serveren.

Met de volgend instructies kan je via Nginx serveren met SPDY.

Nginx installeren

Het Nginx team op launchpad verzorgt een up to date PPA. Hierdoor is de nieuwste stabiele versie altijd beschikbaar, ook als de versie in de standard Ubuntu repository verouderd is.

# nginx stable ppa aan het systeem toevoegen
sudo add-apt-repository ppa:nginx/stable
# package list updaten
sudo apt-get update
# nginx installeren
sudo apt-get install nginx

Open http://localhost/ en de standaard Welcome to nginx! pagina zal laden.

Nginx configureren

Als voorbeeld, zal de volgende configuratie instructies, de documentatie van bootstrap lokaal hosten met Nginx via SPDY.

# maak een www dir aan in home
mkdir ~/www
# ga in de www dir ~/www
cd ~/www
# download de documentatie zip
wget https://github.com/twbs/bootstrap/archive/gh-pages.zip
# pak de zip uit
unzip gh-pages.zip
# verwijder de gedownloade zip
rm gh-pages.zip

Nginx configuratie layout in Ubuntu

/etc/nginx/nginx.conf
- Basis instellingen beheerd door het Nginx team.
/etc/nginx/sites-available/
- Site specifieke configuraties, oftewel virtual host configs. Deze erven de instellingen uit nginx.conf.
/etc/nginx/sites-enabled/
- Symlinks naar virtual hosts uit /etc/nginx/sites-available/, een virtual host die hier gelinkt is wordt opgepakt door Nginx.
/etc/nginx/conf.d/
- De plek voor overige configuraties. Nginx pakt elke *.conf in deze directory op. Zet hier instellingen neer om nginx.conf uit te breiden of te overulen. Hierdoor zal een updaten van Nginx nooit voor een conflict zorgen in nginx.conf.

Zo wordt de Welcome to nginx! pagina door Nginx gehost.

ls -lah /etc/nginx/sites-available/
# totaal 12K
# drwxr-xr-x 2 root root 4,0K aug 27 22:19 .
# drwxr-xr-x 5 root root 4,0K aug 27 22:19 ..
# -rw-r--r-- 1 root root 2,6K apr 24 18:23 default

ls -lah /etc/nginx/sites-enabled/
# totaal 8,0K
# drwxr-xr-x 2 root root 4,0K aug 27 22:19 .
# drwxr-xr-x 5 root root 4,0K aug 27 22:19 ..
# lrwxrwxrwx 1 root root   34 aug 27 22:19 default -> /etc/nginx/sites-available/default

# default uitzetten
sudo rm /etc/nginx/sites-enabled/default
sudo service nginx restart
# * Restarting nginx nginx
#   ...done.
# http://localhost/ zal nu niets laden.

# default aanzetten
sudo ln -s /etc/nginx/sites-available/default /etc/nginx/sites-enabled/
sudo service nginx restart
# * Restarting nginx nginx
#   ...done.
# http://localhost/ zal nu weer default laden.

Nginx http virtual host

Maak /etc/nginx/sites-available/bootstrap aan met de volgende inhoud.

server {
        # luister naar de default http port
        listen 80;

        # maak de site beschikbaar op http://bootstrap.localtest.me
        server_name bootstrap.localtest.me;

        # stel de root in op de bootstrap documentatie
        root /home/mijnusernaam/www/bootstrap-gh-pages;

        location / {
                # Probeer de request als bestand te serveren, daarna
                # als directory, daarna terugvallen op 404 foutcode.
                try_files $uri $uri/ =404;
        }
}

# symlink de vhost naar sites-enabled
sudo ln -s /etc/nginx/sites-available/bootstrap /etc/nginx/sites-enabled/
# herstart nginx
sudo service nginx restart

Open http://bootstrap.localtest.me.

Nginx https virtual host

Voeg het volgende toe in /etc/nginx/ssl_session.conf. Hiermee wordt de cpu wat ontlast doordat er minder SSL handshakes zullen plaatsvinden.

ssl_session_cache shared:SSL:10m;
ssl_session_timeout 10m;

De bootstrap vhost ziet er voor https als volgt uit. Let op, deze gebruikt een zelf gesigneerde certificaat die door Ubuntu is gegenereerd. Gebruik deze oplossing niet in productie!

server {
        # luister naar de default http port
        listen 80;
        # maar redirect http naar https
        if ($scheme = http) {
                return 301 https://$server_name$request_uri;
        }

        # luister naar de https port met ssl
        listen 443 ssl;

        # ssl instellingen
        ssl_certificate /etc/ssl/certs/ssl-cert-snakeoil.pem;
        ssl_certificate_key /etc/ssl/private/ssl-cert-snakeoil.key;
        ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
        ssl_prefer_server_ciphers on;
        ssl_ciphers "EECDH+ECDSA+AESGCM EECDH+aRSA+AESGCM EECDH+ECDSA+SHA384 EECDH+ECDSA+SHA256 EECDH+aRSA+SHA384 EECDH+aRSA+SHA256 EECDH+aRSA+RC4 EECDH EDH+aRSA RC4 !aNULL !eNULL !LOW !3DES !MD5 !EXP !PSK !SRP !DSS";

        # geef aan de client door dat alle requests over https moeten gaan
        add_header Strict-Transport-Security "max-age=31536000; includeSubDomains";

        # maak de site beschikbaar op http://bootstrap.localtest.me
        server_name bootstrap.localtest.me;

        # stel de root in op de bootstrap documentatie
        root /home/mijnusernaam/www/bootstrap-gh-pages;

        location / {
                # Probeer de request als bestand te serveren, daarna
                # als directory, daarna terugvallen op 404 foutcode.
                try_files $uri $uri/ =404;
        }
}

Herstart Nginx met sudo service nginx restart en open https://bootstrap.localtest.me. Je krijgt een waarschuwing omdat het certificaat niet geauthoriseerd is.

Nginx SPDY virtual host

Voeg spdy toe achter ssl in de Nginx https virtual host

server {
        # luister naar de default http port
        listen 80;
        # maar redirect http naar https
        if ($scheme = http) {
                return 301 https://$server_name$request_uri;
        }

        # luister naar de https port met ssl
        listen 443 ssl spdy;

De volledige Nginx SPDY virtual host ziet er als volgt uit.

server {
        # luister naar de default http port
        listen 80;
        # maar redirect http naar https
        if ($scheme = http) {
                return 301 https://$server_name$request_uri;
        }

        # luister naar de https port met ssl
        listen 443 ssl spdy;

        # ssl instellingen
        ssl_certificate /etc/ssl/certs/ssl-cert-snakeoil.pem;
        ssl_certificate_key /etc/ssl/private/ssl-cert-snakeoil.key;
        ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
        ssl_prefer_server_ciphers on;
        ssl_ciphers "EECDH+ECDSA+AESGCM EECDH+aRSA+AESGCM EECDH+ECDSA+SHA384 EECDH+ECDSA+SHA256 EECDH+aRSA+SHA384 EECDH+aRSA+SHA256 EECDH+aRSA+RC4 EECDH EDH+aRSA RC4 !aNULL !eNULL !LOW !3DES !MD5 !EXP !PSK !SRP !DSS";

        # geef aan de client door dat alle requests over https moeten gaan
        add_header Strict-Transport-Security "max-age=31536000; includeSubDomains";

        # maak de site beschikbaar op http://bootstrap.localtest.me
        server_name bootstrap.localtest.me;

        # stel de root in op de bootstrap documentatie
        root /home/mijnusernaam/www/bootstrap-gh-pages;

        location / {
                # Probeer de request als bestand te serveren, daarna
                # als directory, daarna terugvallen op 404 foutcode.
                try_files $uri $uri/ =404;
        }
}

lees meer

SPDY is an experiment with protocols for the web
Can I use SPDY?
Guide to Nginx + SSL + SPDY
Nginx Configuration
NGINX SSL Termination

Een ruby omgeving per project in Ubuntu

Sat, 16 Aug 2014 14:31:26 +0000

Met de volgende instructies kan een Ruby ontwikkel omgeving op directory niveau ingesteld worden, onafhankelijk van Ubuntu’s package manager. Hiermee voorkom je de situatie dat een project een Ruby versie nodig heeft, die niet wordt aangeboden door de packagemanager. Een ander groot voordeel is dat verschillende Ruby versies naast elkaar gebruikt kunnen worden.

rbenv en plugins installeren

clone de repositories naar de juiste directories.

git clone https://github.com/sstephenson/rbenv.git ~/.rbenv
git clone https://github.com/sstephenson/ruby-build.git ~/.rbenv/plugins/ruby-build
git clone https://github.com/sstephenson/rbenv-gem-rehash.git ~/.rbenv/plugins/rbenv-gem-rehash
git clone https://github.com/ianheggie/rbenv-binstubs.git ~/.rbenv/plugins/rbenv-binstubs
git clone https://github.com/rkh/rbenv-update.git ~/.rbenv/plugins/rbenv-update

voeg het volgende toe aan ~/.bashrc.

# rbenv
export PATH="$HOME/.rbenv/bin:$PATH"
eval "$(rbenv init -)"

sluit de huidige terminal en start een nieuwe. Test het commando rbenv.

rbenv
# rbenv 0.4.0-98-g13a474c
# Usage: rbenv <command> [<args>]
#
# Some useful rbenv commands are:
#    commands    List all available rbenv commands
#    local       Set or show the local application-specific Ruby version
#    global      Set or show the global Ruby version
#    shell       Set or show the shell-specific Ruby version
#    install     Install a Ruby version using ruby-build
#    uninstall   Uninstall a specific Ruby version
#    rehash      Rehash rbenv shims (run this after installing executables)
#    version     Show the current Ruby version and its origin
#    versions    List all Ruby versions available to rbenv
#    which       Display the full path to an executable
#    whence      List all Ruby versions that contain the given executable
#
# See `rbenv help <command>' for information on a specific command.
# For full documentation, see: https://github.com/sstephenson/rbenv#readme

rbenv gebruiken

ruby installeren

Installeer de volgende dependencies om ruby te kunnen builden met rbenv.

sudo apt-get install autoconf bison build-essential libssl-dev libyaml-dev libreadline6 libreadline6-dev zlib1g zlib1g-dev

# laat alle installeerbare ruby versies zien
rbenv install -l
# installeer ruby versie 2.1.2
rbenv install 2.1.2

ruby versie gebruiken

Ga naar de root directory van het project waar je een bepaalde ruby versie wilt gebruiken.

cd mijn-app
# laat de geinstalleerde ruby versies zien
rbenv versions
# gebruik ruby versie 2.1.2 in deze en bovenliggende directories
rbenv local 2.1.2
# laat de actieve ruby in deze directory zien
rbenv version

Het command rbenv local 2.1.2 creeërt een .ruby-version bestand in de huidige directory. Hierin wordt de ruby versie opgeslagen. Voeg dit bestand toe aan versiebeheer zodat de ruby versie wordt opgelagen in het project.

bundler gebruiken

Als bundler binnen het project wordt gebruikt roep de install dan op de volgende wijze aan.

bundle install --binstubs .bundle/bin

Hierdoor kunnnen de commando’s die bundler installeert zonder bundle exec aangeroepen worden.

rbenv updaten

rbenv update
# updating rbenv
#  |  Already on 'master'
#  |  Your branch is up-to-date with 'origin/master'.
#  |  From https://github.com/sstephenson/rbenv
#  |  * branch            master     -> FETCH_HEAD
#  |  Already up-to-date.
#
# updating rbenv-binstubs
#  |  Already on 'master'
#  |  Your branch is up-to-date with 'origin/master'.
#  |  From https://github.com/ianheggie/rbenv-binstubs
#  |  * branch            master     -> FETCH_HEAD
#  |  Already up-to-date.
#
# updating rbenv-gem-rehash
#  |  Already on 'master'
#  |  Your branch is up-to-date with 'origin/master'.
#  |  From https://github.com/sstephenson/rbenv-gem-rehash
#  |  * branch            master     -> FETCH_HEAD
#  |  Already up-to-date.
#
# updating rbenv-update
#  |  Already on 'master'
#  |  Your branch is up-to-date with 'origin/master'.
#  |  From https://github.com/rkh/rbenv-update
#  |  * branch            master     -> FETCH_HEAD
#  |  Already up-to-date.
#
# updating ruby-build
#  |  Already on 'master'
#  |  Your branch is up-to-date with 'origin/master'.
#  |  From https://github.com/sstephenson/ruby-build
#  |  * branch            master     -> FETCH_HEAD
#  |  Already up-to-date.
#
# reloading rbenv
#  |  done

lees meer

rbenv
ruby-build
rbenv-gem-rehash
rbenv-binstubs
rbenv-update