WHO'S TALKING? Edvinas Aleksejonokas Member of OXID core team Joined two years ago

Transcription

1 OXID VM & SDK

2 WHO'S TALKING? Edvinas Aleksejonokas Member of OXID core team Joined two years ago

3 WHO'S TALKING? HONESTLY... A person who was really feed up by the fact that: Everyone had their own dev-env Everyone had their own set of problems "It runs on my machine" was the attitude ATM Later I understood that I'm not the only one who had problems with these facts

4 REASONING

5 WHY? #1 Very developer-centric: From Developers By Developers For Developers

6 WHY? #2 Encapsulated/OS agnostic solution Easy kick-start for new developers Common work-flow for everyone No more "It works on my machine!" Have same problems to solve/collaborate

7 QUICK START

8 HOW TO GET? git clone --recursive --recursive details later

9 cd oxvm_eshop vagrant up HOW TO RUN?

10 HOW TO CHECK? open in browser or (for the terminal addicted ones): curl -I grep HTTP HTTP/ OK

11 VISUAL GUIDE

12

13

14

15 Optional

16

17

18

19

20

21

22

23

24 WHAT'S INCLUDED?

25 Ubuntu LTS subsystem Apache MySQL PHP 5.5.9

26 These are the safe default versions, feel free to experiment with newer stuff!

27 OXID ESHOP Latest CE edition directly from master branch Feel free to use your own PE/EE/Encoded/Patched version

28 OXID SDK OXID-eSales/testing_library OXID-eSales/module_skeleton_generator OXID-eSales/module_certification_tools More details later

29 Base php Ubuntu package phpbrew/phpbrew XDebug

30 Base MySQL Ubuntu package vrana/adminer

31 composer itself hirak/prestissimo

32 BACKEND mailhog/mailhog sendmail integrated with mailhog

33 Selenium 2.47 Firefox 31 Ubuntu package Base Ubuntu packages:

34 xfce4 xvfb x11vnc openjdk-7-jre-headless

35 Varnish 4.0.3

36 IonCube 5.1.2

37 WHAT'S NEXT?

38 THINGS TO DO! Try out any recent OXID eshop version Try out our SDK components Use VM for OXID eshop project development Create/Develop/Test OXID eshop module Create experiments and prototypes

39 HOW TO CONFIG?

40 Type some YAML into personal.yml file!

41 CHANGE ESHOP VERSION eshop: source: version: b-5.3-ce It takes master by default

42 php: version: 7 CHANGE PHP VERSION

43 vagrant_local: vm: provider: lxc CHANGE VM PROVIDER Virtualbox, parallels, vmware and lxc

44 CHANGE SHARED FOLDER vagrant_local: vm: app_shared_folder: source: /home/oxid/documents/projects/eshop target: /var/www/eshop eshop_target_path: /var/www/eshop

45 USE NFS WITH SHARED FOLDER vagrant_local: vm: app_shared_folder: sync_type: nfs Use sync_type: ~ to get default for provider

46 CHANGE VIRTUAL HOST vagrant_local: vm: aliases: -

47 varnish: install: true ENABLE VARNISH

48 selenium: install: true ENABLE SELENIUM

49 php: ioncube: install: true ENABLE IONCUBE

50 CHANGE OS PACKAGES MIRROR server: apt_mirror:

51 ADD CUSTOM PACKAGES server: personal_packages: - vim - htop - mc

52 PLETHORA OF CONFIG OPTIONS --- vagrant_local: vm: name: ce-410 provider: lxc base_box: ubuntu/trusty64 hostname: ce-410.dev aliases: - ip: memory: '512' cpus: 1 app_shared_folder: source: oxideshop target: "/var/www/oxideshop" sync_type: nfs owner: vagrant

53 STRUCTURE

54 REPOSITORIES OXID-eSales/oxvm_base LAMP, phpbrew, composer, xdebug, varnish, ioncube, adminer, mailhog... OXID-eSales/oxvm_eshop OXID eshop, SDK, selenium, varnish integration OXID-eSales/oxvm_assets Large files/binaries needed for VM

55 REPOSITORY SUB-MODULES \oxvm_eshop base_vm -> oxvm_base Main reason why --recursive flag is used during the checkout of oxvm_eshop repository

56 DEFAULT CONFIGURATION VALUES oxvm_base/ansible/vars/default.yml php: install: true... oxvm_eshop/ansible/vars/oxideshop.yml eshop: config: utf_mode: 0...

57 ROLES ENTRY POINT oxvm_base/ansible/roles/ apache php varnish ioncube... oxvm_eshop/ansible/roles/ ox_eshop ox_selenium

58 ROLE TASK STRUCTURE ansible/roles/varnish/tasks/ (Just an example): main.yml (Mandatory requirement by Ansible) install.yml uninstall.yml

59 MERGE ORDER OF CONFIGURATION VALUES [BASE VM] oxvm_base/ansible/playbook.yml: Inherited vars/default.yml Configurable ~/.personal_ansible_vm.yml../personal.yml

60 MERGE ORDER OF CONFIGURATION VALUES [OXID VM] oxvm_eshop/ansible/oxid.yml: Inherited../base_vm/ansible/vars/default.yml vars/oxideshop.yml Configurable ~/.personal_ansible_vm.yml../personal.yml

61 SDK

62 ATM THREE ITEMS Module skeleton generator Module certification tools Testing library

63 MODULE SKELETON GENERATOR A module which is installed by default It needs to be activated manually! Use it to create new modules

64 VISUAL GUIDE

65

66

67

68

69

70

71 MODULE CERTIFICATION TOOLS Generates code quality metrics Rough estimation of price for module certification Invocation: ox_cert <vendor_name>/<module_name>

72

73 TESTING LIBRARY Collection of tools for testing: reset-shop runmetrics runtests runtests-coverage runtests-selenium

74 UNIT/INTEGRATION TESTS

75

76 REMINDER Don't forget to run tests before suggesting a PR

77 RECENT CHANGES

78

79 NEW STUFF Ubuntu LTS support (LXC) Ansible 2.0 support Integration of IonCube prestissimo (composer) adminer config command for vagrant

80 CHANGES BindFS transferred to Provision part (ansible) Default backingstorage was specified (for LXC) display_errors are turned on by default

81 FIXES sync_type reference (for NFS) Force-less umount (for LXC)

82 TIPS & TRICKS

83 IN CASE OF PROBLEMS 95% of time blame the configuration Use new vagrant command: vagrant config This will allow to see the merged YAML configuration

84 SAVE TIME WITH BOX PACKAGES Use vagrant command vagrant package to produce box packages Use that box via personal.yml configuration --- vagrant_local: vm: base_box: cache.box

85 USE NFS Sync type Native NFS Shared folder Speed 2200 MBytes/s 320 MBytes/s 10 MBytes/s

86 AVOID VIRTUALBOX Use proprietary hypervisor Don't use emulated hardware

87 USE LXC Use it by default if you're host has a linux kernel Use it inside a hypervisor if you're planning to use several VM instances You can look at an example: rezonanc-oxid/lxc-box

88 PROVIDE GITHUB TOKEN --- php: composer: github_token: example_secret_token

89 USE LOCAL REPOSITORIES/MIRRORS --- php: phpbrew: cache: repo: composer: installer_url: mailhog: pkg_url: Reduce the provision time down-to 1 minute

90 USE BASE VM FOR OTHER PROJECTS Fork it Improve/Hack it Use it for your own projects: Django Rails Node.js...

91 FUTURE VISION

92

93 QUESTIONS/FEEDBACK

94 RELATED QUESTIONS?

95 ANY NON-RELATED QUESTIONS?

96 POSITIVE FEEDBACK? :)

97 NEGATIVE??? :/

98 THANK YOU!