{"id":14065696,"url":"https://github.com/cfn-sphere/simple-container-runtime","last_synced_at":"2026-04-13T17:32:29.568Z","repository":{"id":57467335,"uuid":"100688850","full_name":"cfn-sphere/simple-container-runtime","owner":"cfn-sphere","description":"Just what it is named, an easy way to run docker containers on any kind of instance with respect to production grade requirements!","archived":false,"fork":false,"pushed_at":"2017-11-24T16:27:16.000Z","size":33,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-04T14:37:59.962Z","etag":null,"topics":["aws-ec2","docker","docker-compose","infrastructure","scr"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cfn-sphere.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-08-18T08:06:53.000Z","updated_at":"2021-12-04T04:28:59.000Z","dependencies_parsed_at":"2022-09-17T16:12:13.635Z","dependency_job_id":null,"html_url":"https://github.com/cfn-sphere/simple-container-runtime","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cfn-sphere/simple-container-runtime","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cfn-sphere%2Fsimple-container-runtime","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cfn-sphere%2Fsimple-container-runtime/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cfn-sphere%2Fsimple-container-runtime/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cfn-sphere%2Fsimple-container-runtime/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cfn-sphere","download_url":"https://codeload.github.com/cfn-sphere/simple-container-runtime/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cfn-sphere%2Fsimple-container-runtime/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267619069,"owners_count":24116490,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-29T02:00:12.549Z","response_time":2574,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws-ec2","docker","docker-compose","infrastructure","scr"],"created_at":"2024-08-13T07:04:38.418Z","updated_at":"2026-04-13T17:32:24.548Z","avatar_url":"https://github.com/cfn-sphere.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# SCR - Simple-Container-Runtime\n\n[![Build Status](https://travis-ci.org/cfn-sphere/simple-container-runtime.svg?branch=master)](https://travis-ci.org/cfn-sphere/simple-container-runtime)\n\n[![Code Health](https://landscape.io/github/cfn-sphere/simple-container-runtime/master/landscape.svg?style=flat)](https://landscape.io/github/cfn-sphere/simple-container-runtime/master)\n\nThis project aims to be a really simple solution to run Docker containers on AWS EC2 instances.\n\n### Why\n\nThere are solutions out there like AWS ECS, Kubernetes and so on. They all do a good job on their own. But what if I simply want to run some containers without the complexity of maintaining all the things around. Even if AWS ECS brings a lot out of the box and Kubernetes can be run by simply executing a script there is a lot to do to really have a production ready system.\n\nDon't get me wrong, SCR is not specifically intended to run all containers on a single box. It is designed to be simple and leave topics other than running containers on one instance to other infrastructure components. It perfectly fits into a world where infrastructure is maintained by AWS CloudFormation and instances run in AWS AutoScaling groups for scalability.\n\n### How\n\nSCR is build around docker-compose. Users can simply use a docker-compose.yaml file stored in S3, on filesystem or any reachable webserver run their app. One can extend the config for specific use cases like health checks, instance preparation, status signaling and so on but in the end it is up to your usecase. Stick with a simple plain docker-compose config or use all the modules available.\n\n## Give it a try\n\nAll theory is gray. Give it a try without a lot of hazzle. Let SCR start a container with wordpress and another one with mysql for you:\n\n    pip install scr\n    scr run quickstart/wordpress-with-mysql.yaml\n    \nAfter some time waiting for the images to load scr finally executes a local heathcheck to make sure that wordpress is up and running. \nYou can connect on [http://localhost:8000](http://localhost:8000). Simply press CTRL+C to gracefully stop everything.\n\n## Build it\n\nThis project uses pybuilder as build tool.\n\n    pip install pybuilder\n    pyb install_dependencies\n    pyb\n\n## Requirements\n\nPython 3 is required\n\n## Install it\n\nA Package is available at the Python Package Index: https://pypi.python.org/pypi?name=simple-container-runtime\u0026:action=display\n\n    pip install simple-container-runtime\n \n## Run it\n\n    scr run [options] my-config-file\n    \n### Examples\n    \n#### load configuration from filesystem\n    scr run /etc/my-app-config.yaml\n    \n#### load configuration from S3\n    scr run s3://my-bucket/my-app-config.json\n\n#### Get configuration from any http(s) server\n    scr run http://my-infrastructure.service/my-app-config.yaml\n    \n#### Run on an EC2 instance and get configuration from instance user-data\n\nThis is the prefered way to configure scr on EC2 instances. You can use cfn-sphere to simply create AWS CloudFormation templates properly configuring user-data.\n\n    scr run http://169.254.169.254/latest/user-data\n    \n## Example Config Yaml\n\n    # things to be done before composition starts\n    pre_start:\n      - AwsEcrLogin:\n          region: eu-west-1\n          account_id: 123456789123\n    \n    #health checks to be made executed the composition started to verify its health\n    healthchecks:\n      - http:\n          port: 8000\n      - AwsElb:\n          loadbalancer_name: my-alb\n    \n    # signals to be send to inform the outside world about the status of this composition\n    signals:\n      - AwsCfn:\n          region: eu-west-1\n          stack_name: my-stack\n          logical_resource_id: my-asg\n    \n    #plain docker-compose yaml\n    docker-compose:\n        version: '2'\n        services:\n           db:\n             image: mysql:5.7\n             volumes:\n               - db_data:/var/lib/mysql\n             restart: always\n             environment:\n               MYSQL_ROOT_PASSWORD: wordpress\n               MYSQL_DATABASE: wordpress\n               MYSQL_USER: wordpress\n               MYSQL_PASSWORD: wordpress\n    \n           wordpress:\n             depends_on:\n               - db\n             image: wordpress:latest\n             ports:\n               - \"8000:80\"\n             restart: always\n             environment:\n               WORDPRESS_DB_HOST: db:3306\n               WORDPRESS_DB_PASSWORD: wordpress\n        volumes:\n            db_data:\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcfn-sphere%2Fsimple-container-runtime","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcfn-sphere%2Fsimple-container-runtime","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcfn-sphere%2Fsimple-container-runtime/lists"}