{"id":20179418,"url":"https://github.com/wunderio/wundertools","last_synced_at":"2025-05-07T01:35:30.689Z","repository":{"id":964792,"uuid":"36460746","full_name":"wunderio/WunderTools","owner":"wunderio","description":"Project reference configuration for use with Ansible \u0026 Vagrant","archived":false,"fork":false,"pushed_at":"2024-01-16T07:49:21.000Z","size":1800,"stargazers_count":18,"open_issues_count":34,"forks_count":9,"subscribers_count":42,"default_branch":"master","last_synced_at":"2024-01-16T13:52:24.193Z","etag":null,"topics":["ansible","drupal","internal"],"latest_commit_sha":null,"homepage":"https://wundertools.wunder.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wunderio.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","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":"2015-05-28T19:20:35.000Z","updated_at":"2024-01-16T13:52:24.194Z","dependencies_parsed_at":"2023-01-11T15:48:45.627Z","dependency_job_id":null,"html_url":"https://github.com/wunderio/WunderTools","commit_stats":null,"previous_names":[],"tags_count":3,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wunderio%2FWunderTools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wunderio%2FWunderTools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wunderio%2FWunderTools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wunderio%2FWunderTools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wunderio","download_url":"https://codeload.github.com/wunderio/WunderTools/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224554246,"owners_count":17330598,"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":["ansible","drupal","internal"],"created_at":"2024-11-14T02:26:32.704Z","updated_at":"2024-11-14T02:26:33.272Z","avatar_url":"https://github.com/wunderio.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Wundertools\n\n**Note!** This project is no longer in active development and receives only maintenance fixes. For new projects, we recommend \u003chttps://github.com/wunderio/drupal-project\u003e instead.\n\nReference setup with Ansible \u0026 Vagrant for Drupal 8 projects. For Drupal 7 support, see the [Drupal 7 branch](https://github.com/wunderio/WunderTools/tree/drupal7).\n\n[![CircleCI](https://circleci.com/gh/wunderio/WunderTools.svg?style=svg)](https://circleci.com/gh/wunderio/WunderTools)\n\n## Requirements\n- Install [Vagrant](https://www.vagrantup.com/downloads.html) 1.9.2 or greater\n- Install [vagrant-cachier](https://github.com/fgrehm/vagrant-cachier)\n `vagrant plugin install vagrant-cachier`\n- Install [Virtualbox](https://www.virtualbox.org/wiki/Downloads) 5.1 or greater. Note version 5.1.24 has a known issue that breaks nfs, do not use it, version 5.1.22 s known to work.\n- Make sure you have python2.7 also installedi (For OS X should be default).\n\n## Creating a new project\n\nIf you are starting a new project, see: [Setup.md](docs/Setup.md)\n\n\n## Setting up an existing project locally\n\nFind the IP-address and hostname that this local environment is configured to use from `conf/vagrant_local.yml` and add\nit to your own `/etc/hosts` file:\n\n`10.0.13.37 local.wundertools.com`\n\nLet Vagrant create your new machine:\n\n`vagrant up`\n\nThis will create a new Virtual machine on your computer, configure it with all the nice bells \u0026 whistles that you can\nthink of (like MariaDB, nginx, Varnish, memcached and whatnot) and start it up for you. This will also install vagrant plugin depedencies, if you encounter issues while installing the plugins then you could use: `vagrant --skip-dependency-manager up`\n\nSSH into your box and build and install Drupal:\n\n```\nvagrant ssh\ncd /vagrant/drupal\n./build.sh new\n```\n\nIf this is a project with an existing production/staging server, you should probably sync the production database now,\nfrom your local machine:\n\n`sync.sh`\n\nDrush is usable without ssh access with the drush.sh script e.g:\n\n```bash\n$ ./drush.sh cr\n```\n\nTo open up ssh access to the virtual machine:\n\n```bash\n$ vagrant ssh\n```\n\n\n## Optional additions\n\n### WunderSecrets\n\nYou can setup additional git repository for shared secrets. You need to set that in `conf/project.yml` -\u003e `wundersecrets: remote: git@github.com:username/repo`.\n\nOnly the file `ansible.yml` is loaded from that repository.\n\n## Useful things\n\nAt the moment IP is configured in\n  Vagrantfile\n    variable INSTANCE_IP\n\nVarnish responds to\n  http://x.x.x.x/\n\nNginx responds to\n  http://x.x.x.x:8080/\n\nSolr responds to\n  http://x.x.x.x:8983/solr\n\nMailHOG responds to\n  http://x.x.x.x:8025\n  or\n  https://local.project.tld/mailhog/\n\nDocs are in\n        http://x.x.x.x:8080/index.html\n        You can setup the dir where the docs are taken from and their URL from the\n        variables.yml file.\n\n        #Docs\n        docs:\n          hostname : 'docs.local.wundertools.com'\n          dir : '/vagrant/docs'\n\n\n## Vagrant + Ansible configuration\n\nVagrant is using Ansible provision stored under the ansible subdirectory.\nThe inventory file (which stores the hosts and their IP's) is located under\nansible/inventory. Host specific configurations for Vagrant are stored in\nansible/vagrant.yml and the playbooks are under ansible/playbook directory.\nVariable overrides are defined in ansible/variables.yml.\n\nYou should only bother with the following:\n\n- Vagrant box setup `conf/vagrant.yml`\n- What components do you want to install? `conf/vagrant.yml`\n- And how are those set up? `conf/variables.yml`\n- You can also fix your vagrant/ansible base setup to certain branch/revision `conf/project.yml`\n  There you can also do the same for build.sh\n\n\n## Debugging tools\n\nXDebug tools are installed via the devtools role. Everything should work out\nof the box for PHPStorm. PHP script e.g. drush debugging should also work.\n\n### Lando debugging\n\nXDebug can be enabled by uncommeting `xdebug: true` in the .lando.yml file. After `lando rebuild` port 9000 is used for XDebug.\n\nNote: Make sure port 9000 is not used in your OS for anything else. You can see all ports in use for example with `lsof -i -n -P`. For example php-fpm might be using port 9000 if you have it running.\n\n## Provisioning with Lando\n\nPerform the following tasks in the project root folder to set up the Lando-based provisioning tool:\n\n1. create the file `~/.ssh/ansible.vault` and save it with the Ansible vault password (search for `Ansible vault password` or similar in the LastPass),\n2. run `lando start`,\n3. use `lando provision` for help and `lando provision \u003ctask\u003e` for provisioning tasks.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwunderio%2Fwundertools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwunderio%2Fwundertools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwunderio%2Fwundertools/lists"}