{"id":19224394,"url":"https://github.com/snowplow-archive/dev-environment","last_synced_at":"2025-04-21T00:30:37.071Z","repository":{"id":12875340,"uuid":"15551760","full_name":"snowplow-archive/dev-environment","owner":"snowplow-archive","description":"Vagrant-based Snowplow development environment with Ansible playbooks to install common tools","archived":true,"fork":false,"pushed_at":"2018-01-29T15:42:40.000Z","size":446,"stargazers_count":11,"open_issues_count":3,"forks_count":12,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-03-12T16:15:51.423Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://snowplowanalytics.com","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/snowplow-archive.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-2.0.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-12-31T15:07:19.000Z","updated_at":"2024-12-13T04:19:45.000Z","dependencies_parsed_at":"2022-08-26T07:01:16.566Z","dependency_job_id":null,"html_url":"https://github.com/snowplow-archive/dev-environment","commit_stats":null,"previous_names":["snowplow-archive/dev-environment"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snowplow-archive%2Fdev-environment","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snowplow-archive%2Fdev-environment/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snowplow-archive%2Fdev-environment/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snowplow-archive%2Fdev-environment/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/snowplow-archive","download_url":"https://codeload.github.com/snowplow-archive/dev-environment/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249979528,"owners_count":21355250,"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-09T15:11:32.202Z","updated_at":"2025-04-21T00:30:37.011Z","avatar_url":"https://github.com/snowplow-archive.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Snowplow Development Environment\n\n[Vagrant] [vagrant]-based development environment with [Ansible] [ansible] playbooks to install common tools, including:\n\n* The JVM ecosystem\n* Ruby\n* Postgres\n\nWorks fine on Linux, Mac and Windows hosts.\n\nUsed as the development environment for all [Snowplow Analytics] [snowplow] projects.\n\n## Installation\n\n### Dependencies\n\nTo use this development environment, you need to have [Vagrant] [vagrant-install] and [VirtualBox] [virtualbox-install] installed.\n\nWe also recommend installing vagrant-vbguest to prevent the VirtualBox Guest Additions from getting out of sync:\n\n\t$ vagrant plugin install vagrant-vbguest\n\n### Starting Vagrant\n\nFirst, clone the repo, including `ansible-playbooks` submodule:\n\n\t$ git clone --recursive https://github.com/snowplow/dev-environment.git\n\t$ cd dev-environment\n\nBy default the development environment is configured with 2 GB of RAM. You can adjust this by running the `configure.sh` script, e.g. for 5 GB try:\n\n\t$ ./scripts/configure.sh 5\n\nNow you can build the VM:\n\n\t$ vagrant up\n\nAnd SSH into it:\n\n\t$ vagrant ssh\n\n### Installing software\n\nThe guest VM has Ansible installed. This means you can run the different [Ansible playbooks] [ansible-playbooks] directly, thus:\n\n```\n$ ansible-playbook /vagrant/ansible-playbooks/{{PLAYBOOK_NAME}}.yml \\\n--inventory-file=/vagrant/home/ansible/ansible_hosts --connection=local\n```\n\nFor example, to install the development environment for working on the Snowplow batch-based enrichment process:\n\n```\n$ ansible-playbook /vagrant/ansible-playbooks/snowplow-batch-pipeline.yml \\\n--inventory-file=/home/vagrant/ansible_hosts --connection=local\n```\n\nTo simply install Java-7:\n\n```\n$ ansible-playbook /vagrant/ansible-playbooks/java-7.yml \\\n--inventory-file=/home/vagrant/ansible_hosts --connection=local\n```\n\nA whole host of playbooks can be found in the [ansible-playbooks] (https://github.com/snowplow/ansible-playbooks). Playbooks in the root of the project can be run directly - these are composed of [roles] (https://github.com/snowplow/ansible-playbooks/tree/master/roles) that individually install specific components of development environments. For more information on composing your own development environments out of the individual roles, see the [ansible-playbooks README] (https://github.com/snowplow/ansible-playbooks).\n\n### Starting developing\n\nWe recommend removing git tracking from the dev environment before starting coding. You can do these either from the host or the guest VM:\n\n    $ rm -rf .git*\n\nNow you can safely pull down the codebase you want to work on e.g:\n\n    $ git clone https://github.com/snowplow/snowplow.git\n\n## Available playbooks\n\nPlease see our [Ansible playbooks] [ansible-playbooks] repository for the full list.\n\n## Copyright and license\n\nSnowplow Development Environment is copyright 2014 Snowplow Analytics Ltd.\n\nLicensed under the [Apache License, Version 2.0] [license] (the \"License\");\nyou may not use this software except in compliance with the License.\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n\n[vagrant]: http://vagrantup.com\n[vagrant-install]: http://docs.vagrantup.com/v2/installation/index.html\n[virtualbox]: https://www.virtualbox.org\n[virtualbox-install]: https://www.virtualbox.org/wiki/Downloads\n[ansible]: http://www.ansibleworks.com/\n\n[snowplow]: http://snowplowanalytics.com\n\n[ansible-playbooks]: https://github.com/snowplow/ansible-playbooks\n\n[license]: http://www.apache.org/licenses/LICENSE-2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsnowplow-archive%2Fdev-environment","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsnowplow-archive%2Fdev-environment","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsnowplow-archive%2Fdev-environment/lists"}