The MetaCPAN VM for Dummies Part One (Installation)


Published on

Get up and running with the MetaCPAN VM. This talk walks you through the process of installing the VM.

Published in: Technology, Art & Photos
  • Be the first to comment

  • Be the first to like this

No Downloads
Total views
On SlideShare
From Embeds
Number of Embeds
Embeds 0
No embeds

No notes for slide

The MetaCPAN VM for Dummies Part One (Installation)

  1. 1. The MetaCPAN VM (for Dummies?) Olaf Alders @wundercounter Toronto Perl Mongers Oct 24, 2013 Monday, 11 November, 13
  2. 2. Why bother? Installation and configuration from scratch is non-trivial Remove some of the up-front cost to contributors Develop in an environment which closely mimics deployment Monday, 11 November, 13
  3. 3. Software Requirements VirtualBox Vagrant git Monday, 11 November, 13
  4. 4. Hardware Requirements Less than 1 GB hard disk space Less than 1 GB of RAM Some arbitrary amount of CPU Monday, 11 November, 13
  5. 5. That was the minimum As far as hardware goes, you can scale up Depends on how far you want to take this Monday, 11 November, 13
  6. 6. The MetaCPAN Stack Debian puppet ElasticSearch Catalyst CPAN or miniCPAN or even some arbitrary CPAN dirs perlbrew Monday, 11 November, 13
  7. 7. The Meta Pieces cpan-api (the original MetaCPAN) metacpan-web metacpan-puppet metacpan-developer metacpan-examples Monday, 11 November, 13
  8. 8. How easy is it? mkdir metacpan && cd metacpan git git git git clone clone clone clone git:// git:// git:// git:// cd .. git clone git:// cd metacpan-developer vagrant up && vagrant ssh Monday, 11 November, 13
  9. 9. Guest vs Host Host: your laptop, PC, whatever. your hardware Guest: the installed VM Monday, 11 November, 13
  10. 10. So what? Edit code using the tools you already have installed on the *Host* What? Monday, 11 November, 13
  11. 11. No SSH setup required vagrant ssh “just works” Monday, 11 November, 13
  12. 12. Port Forwarding “Just works” cpan-api http://localhost:5000 metacpan-web http://localhost:5001 Monday, 11 November, 13
  13. 13. Sharing files without scp Files you add to the metacpandeveloper folder will be available in /vagrant Files you add to /vagrant will be available in metacpan-developer Monday, 11 November, 13
  14. 14. Managing services on the guest stop, start, restart services /etc/init.d/metacpan-www /etc/init.d/metacpan-api /etc/init.d/elasticsearch Monday, 11 November, 13
  15. 15. Does it work? http://localhost:5001 Monday, 11 November, 13
  16. 16. Having trouble? The metacpan-developer README has lots of great troubleshooting tips Monday, 11 November, 13
  17. 17. Maybe modules are missing? if the dependencies have changed since the Vagrant boxfile was built, you may be missing some modules sudo /home/metacpan/bin/install_modules Monday, 11 November, 13
  18. 18. You’re ready to hack We’ll discuss how to hack MetaCPAN in next month’s presentation Monday, 11 November, 13