This repository is used to build scater objects and reports (in continuous integration manner) for various publicly available scRNA-Seq datasets used by our group. This pipeline is implemented using docker containers and cloud computing. The resulting website is available here. Below are some notes on the pipeline setup.
The website is generated using MkDocs generator. Links to S3 storage and data annotations are added manually. If you are creating a pull request and adding new data please add its annotations to one of the files in the website
folder.
To list files on the S3 storage please use this link.
- Launch Amazon Linux EC2 instance.
- Using security groups add access to the instance on port 8080.
- Connect to instance and install Jenkins.
- Add permission for Jenkins to run Docker:
sudo usermod -aG docker jenkins
Hard reboot your instance after that. Now Jenkins can run docker images.
- Install
s3cmd
utility to be able to upload data to the S3 storage:
sudo apt-get install s3cmd
-
In Jenkins Export S3 key ID, secret key and region as environmental variables. Use secret text option provided by Jenkins. Some details available here.
-
File listing can be setup on AWS S3 bucket using this plugin.
- Launch Ubuntu Trusty instance (
j1.large
flavour) - Add the instance to the
default
,cloudforms_icmp_in
,cloudforms_ssh_in
cloudforms_web_in
security groups. - Create additional security group:
TCP
with port 8080 (this is needed for Jenkins) and add your instance to this group. - Associate a floating IP (FLOATING_IP) number with your instance.
- Login to instance:
ssh -i ~/.ssh/your_key.pem ubuntu@FLOATING_IP
- In the instance install Jenkins.
To setup Jenkins after installation go to http://FLOATING_IP:8080
-
In the instance install docker.
-
Resolve docker network issues (Sanger OpenStack problem only):
sudo bash -c "echo '{ \"bip\": \"10.10.0.1/16\", \"mtu\": 1400 }' > /etc/docker/daemon.json"
- Add permission for Jenkins to run Docker:
sudo usermod -aG docker jenkins
Hard reboot your instance after that. Now Jenkins can run docker images.
- Install
s3cmd
utility to be able to upload data to the S3 storage:
sudo apt-get install s3cmd
- In Jenkins Export S3 key ID, secret key and region as environmental variables. Use secret text option provided by Jenkins. Some details available here.
# build and deploy
sh deploy.sh $WORKSPACE
To calculate how much you can spend on AWS one can us the AWS Calculator.