Code By
Lucas Mouilleron

A simple web folder.
For Apache web servers.

Features

• List files and folders
• Nice layout
• Password protection:
  • drop a .password file containing the deisred password in folders (and subfolders) you want to protect
  • drop a .nopassword file in folders (and subfolders) you want to deprotect (in case of protected parent)
• Download folder as a zip
• Shares: expiration, path obfuscation, tracking
• README.md files in folders are interpreted and displayed on top

Install

• Requires PHP 5+, Apache 2.4+
• cd _sf;composer install
• Drop the _sf folder in the root folder
• Drop the _sf_assets folder in the root folder
• Create the _sf_shares folders for shares to be activated
• Drop the .htaccess file in the root folder

Customisation

• Don't edit files in /_sf
• Create /_sf_overrides folder
  • Create config.php and override configs defined in _sf/config.php
  • Create style.css and override styles

TODO

• Clean shares
• Python ?

• Everything is in gh-pages branch
• Needed for github pages publication
• To edit the blog, switch to gh-pages branch

HTTP Client Testing Service.

Fork of http://httpbin.org.

Install

• pip install -r requirements.txt

Run

• cd .
• gunicorn -b localhost:8080 httpbin:app

PSL : A simple python script launcher with global params overridance.

Concept

• It happens you need to run some scripts in a row
• It happens as well you need to run a script with different params contexts
• PSL allows to launch scripts and externally override global params
• In a script, lib.PSLUpdateGlobalsFromEncodedCallArgs() hooks PSL in (previously defined global params can be potentially overriden)
• From a launcher script, lib.PSLLaunch(scriptFile, scriptArgs, globalParams) will launch the script scriptFile, with args scriptArgs, and will override global params with globalParams
• globalParams is a dictionnary of global params :
  • The keys are the name of a script global params
  • If the global param is not defined in the script, no failure
  • If the the global param is defined in the script :
    • If it is a dictionnary, the dics are merged
    • If not, the value is overriden
• The globalParams are actually sent to the script as a base64 encoded string as the named arg --updateGlobals
• In PSLed script, the global params are updated with inspect.currentframe()

Demo implementation

• scriptLauncher.py is the launcher script
• scriptX.py are test launched scripts
• params.json is defining groups of runs
• A run is a python script + its global params overridances
• Tests:
  • Manual / traditionnal launching : python script1.py
  • PSL lauching on all groups : python scriptLauncher.py all
  • PSL lauching on a specific group : python scriptLauncher.py smalls

Installation

• python 3
• pip install -r requirements.txt

RTree tests.
Based on https://github.com/aled/jsi

Run

• ant getDependencies
• ant run

JavaRX boilerplate.

Run

• ant getDependencies
• ant run

Docs

• http://reactivex.io/documentation/observable.html

dockerManager is a local and remote Docker deployment tool for git versionned projects.
Ideal for web agency testing.

Concepts

• Local and remote Docker deployment for github projects
• Project ports and shared folder configuration
• Project environment variable for runtime environment context (and not at buildtime)
• Project add wizard (auto port offseting)
• Export containers files or folders of projects to the dockerManager host (see exportCommnds and exportFilesAndFolders)

Installation

• Install Docker on target hosts (on MacOS, install docker-machine and install a machine named config/config.json > defaultDockerMachineName)
• Install php and composer
• Create ssh key : ssh-keygen -f ./config/id_rsa and then give to repository provider (eg. github)
• composer install
• Edit config/config.json if needed
• bin/dm install

Project compliancy

• Dockerfile must be in PROJECT_ROOT/docker folder
• Project should be cloned at the runtime of the docker container. The revision is passed in the REVISION env variable.
• Project environment variable is by default passed in the ENVIRONMENT env variable, which can be override in project configuration attribute environmentVariable
• Containers are ran as daemons

• Containers should not expose ports above config/config.json > publicAutoPortOffset

• Project github.com:lucasmouilleron/dockeranagerTest can be used for reference

• Projects are configured in config/projects.json

Local VS Remote deployment

• Target deployment hosts are defined per project in config/config.json > URI
• Project can be deloyed localy :"URI":"local"
• Or remotely : "URI":"user@host"
• In the case of remote hosts, make sure to ssh-copy-id the URI so remote calls won't need password typing

How to use

• bin/dm and follow instructions
• Run the test project : bin/dm run test, bin/dm run test REVISION_NUMBER
• API, TODO

Thinking

• For the Dockerfile and/or the docker container to be able to git clone the project, an ssh key must be provided. One solution is to embed the key in the repository. The key can be then associated to a user account (or to the repository deployment keys, which is a per project configuration) on the git repository provider.
• On tester / client machines, use /etc/hosts or GasMask or HostMan so the production domain / URL points to the Docker server
• Webapps : App environment at runtime ?
• Websites : Avoid absolute urls, so the port is forwarded to the next page.

TODO

• Explain export
• Improve dm commands output
• API :
  • REST
  • tokens
  • start and stop projects
  • list running projects
• Sharedfolder in buildImage
• multiple git provider (github, some gitlabs)

Compile

• mkdir classes
• scalac -d classes *.scala *.java
• javac -d classes -classpath $SCALA_HOME/lib/scala-library.jar:target/classes *.java

Run

• scala -cp classes test.HelloWorld

Doc

• http://www.codecommit.com/blog/scala/joint-compilation-of-scala-and-java-sources
• http://stackoverflow.com/questions/28158173/building-a-project-with-mixed-scala-and-java-source-files-using-ant-illegal-cy

Test project for the dockerManger project : https://github.com/lucasmouilleron/dockerManager

Notes

• This a simple web server container which serves a simple index.html file.
• The docker/id_rsa* key has been added to the github project deployment keys so it can be deployed from the Dockerfile. In production, use private repositories and assoiate ssh keys to git provider (eg github) user account.

Tests

• From dockerManager
• Build and run : cd docker, docker build -t test . and docker run -ti -p 8090:80 test