{"id":18300308,"url":"https://github.com/docnow/diffengine-ansible","last_synced_at":"2025-04-09T09:26:38.734Z","repository":{"id":74853003,"uuid":"98205849","full_name":"DocNow/diffengine-ansible","owner":"DocNow","description":"Diff Engine Installer","archived":false,"fork":false,"pushed_at":"2017-07-24T18:42:58.000Z","size":25,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-02-15T03:31:58.437Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DocNow.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-07-24T15:27:40.000Z","updated_at":"2017-07-24T15:35:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"df7c7399-621a-4833-b890-90e2b9ec3bc8","html_url":"https://github.com/DocNow/diffengine-ansible","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DocNow%2Fdiffengine-ansible","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DocNow%2Fdiffengine-ansible/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DocNow%2Fdiffengine-ansible/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DocNow%2Fdiffengine-ansible/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DocNow","download_url":"https://codeload.github.com/DocNow/diffengine-ansible/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248010517,"owners_count":21032929,"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","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":[],"created_at":"2024-11-05T15:11:59.805Z","updated_at":"2025-04-09T09:26:38.705Z","avatar_url":"https://github.com/DocNow.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# diffengine-ansible\nDiff Engine Installer\n\n## Install Diffengine on AWS EC2\n\nUsing this playbook will cost you money. Depending on how long your leave your\nec2 running this will be charged to your AWS account. This has been tested on\nMac OSX and Ubuntu xenial.\n\n### Prerequisites\n\nYou will need to install on  [Ansible](https://ansible.com) using. (using the OSX package manager `homebrew` did not work)\n\n```\npip install -U ansible\n```\n\nand the Python's boto package with\n\n```\npip install -U boto\n```\n\n### Set up AWS\n\nBefore running this playbook do the following to prepare\n\n* create AWS access and security key  - see [Amazon's\n  docs](http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html)\n\nWe will save these credentials in a file with the following steps\n\n```\nmkdir ~/.aws\n```\n\nif you don't already have one. Then add a `credentials` file with your access\nand secret keys in this directory. The contents of the file should look like\nthis\n\n```\ncat ~/.aws/credentials \n[default]\naws_access_key_id = AYOURKEYFILE\naws_secret_access_key = Jyoursecretkeymagicalfilet\n```\n\n\n### Set up your host\n\nGenerate an ssh key that will connect to your AWS instance with\n\n```\nssh-keygen -b 2048 -t rsa -C \"awsdocnow\" -f ~/.ssh/awsdocnow\n```\n\nThis file will also be used later. \n\nMake a copy of `examples_aws_variables.yml` with\n\n```\ncp examples_aws_variables.yml aws_variables.yml\n```\n\nCopy your access and security key in the `aws_variables.yml` file. Make sure your AWS region matches the region you logged into and change it accordingly. If you want a beefier size machine change that also. In addition copy the ssh-key generated above to replace the `ssh_public_key` variable. If you followed the steps above it would read \n\n```\nssh_public_key: '~/.ssh/awsdocnow.pub'\n```\n\nThe boto file installed on MacOSX fails to be imported to your library for\n[whatever reason](https://github.com/boto/boto/issues/3194) so export the python\npath with\n\n```\nexport PYTHONPATH=/usr/local/lib/python2.7/site-packages\n```\n\n### Run the playbook\n\nAdd your generated key to your session with\n\n```\nssh-add ~/.ssh/awsdocnow\n```\n\nIf you run\n\n```\nssh-add -l\n```\n\nIt will list your newly generated key.\n\nYou are now ready to install Diffengine at an AWS endpoint with\n\n```\nansible-playbook -vvvv -i inventory/ec2.py install_diffengine.yml -u ubuntu -b\n```\n\nWe use the verbose so it lists the AWS ip you will be logging into upon completion which will look *similar* to this.\n\n```\nMETA: ran handlers\nMETA: ran handlers\n\nPLAY RECAP **********************************************************************************************************************************************************************************************************\n1.2.3.4              : ok=7    changed=6    unreachable=0    failed=0\nlocalhost                  : ok=9    changed=3    unreachable=0    failed=0\n```\n\nYou can the ssh to your VM and run `diffengine` with\n\n```\nssh ubuntu@1.2.3.4\nubuntu@ip-172-31-26-233:~$ diffengine\nWhat RSS/Atom feed would you like to monitor?\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocnow%2Fdiffengine-ansible","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdocnow%2Fdiffengine-ansible","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocnow%2Fdiffengine-ansible/lists"}