mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-06-29 01:44:36 -04:00
[doc] fix asciidoc format
This commit is contained in:
parent
0314ccd2a0
commit
b93a75f309
1 changed files with 38 additions and 0 deletions
|
@ -321,11 +321,13 @@ Vagrant. You can get started by following there five easy steps:
|
||||||
|
|
||||||
. (Optional) Install vagrant-cachier to squeeze a bit more performance out of
|
. (Optional) Install vagrant-cachier to squeeze a bit more performance out of
|
||||||
the process:
|
the process:
|
||||||
|
|
||||||
--------------------------------------
|
--------------------------------------
|
||||||
vagrant plugin install vagrant-cachier
|
vagrant plugin install vagrant-cachier
|
||||||
--------------------------------------
|
--------------------------------------
|
||||||
|
|
||||||
. Validate your installed dependencies:
|
. Validate your installed dependencies:
|
||||||
|
|
||||||
-------------------------------------
|
-------------------------------------
|
||||||
mvn -Dtests.vagrant -pl qa/vagrant validate
|
mvn -Dtests.vagrant -pl qa/vagrant validate
|
||||||
-------------------------------------
|
-------------------------------------
|
||||||
|
@ -334,11 +336,14 @@ mvn -Dtests.vagrant -pl qa/vagrant validate
|
||||||
from Vagrant when you run it inside mvn its probably best if you run this one
|
from Vagrant when you run it inside mvn its probably best if you run this one
|
||||||
time to setup all the VMs one at a time. Run this to download and setup the VMs
|
time to setup all the VMs one at a time. Run this to download and setup the VMs
|
||||||
we use for testing by default:
|
we use for testing by default:
|
||||||
|
|
||||||
--------------------------------------------------------
|
--------------------------------------------------------
|
||||||
vagrant up --provision trusty && vagrant halt trusty
|
vagrant up --provision trusty && vagrant halt trusty
|
||||||
vagrant up --provision centos-7 && vagrant halt centos-7
|
vagrant up --provision centos-7 && vagrant halt centos-7
|
||||||
--------------------------------------------------------
|
--------------------------------------------------------
|
||||||
|
|
||||||
or run this to download and setup all the VMs:
|
or run this to download and setup all the VMs:
|
||||||
|
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
vagrant halt
|
vagrant halt
|
||||||
for box in $(vagrant status | grep 'poweroff\|not created' | cut -f1 -d' '); do
|
for box in $(vagrant status | grep 'poweroff\|not created' | cut -f1 -d' '); do
|
||||||
|
@ -349,24 +354,32 @@ done
|
||||||
|
|
||||||
. Smoke test the maven/ant dance that we use to get vagrant involved in
|
. Smoke test the maven/ant dance that we use to get vagrant involved in
|
||||||
integration testing is working:
|
integration testing is working:
|
||||||
|
|
||||||
---------------------------------------------
|
---------------------------------------------
|
||||||
mvn -Dtests.vagrant -Psmoke-vms -pl qa/vagrant verify
|
mvn -Dtests.vagrant -Psmoke-vms -pl qa/vagrant verify
|
||||||
---------------------------------------------
|
---------------------------------------------
|
||||||
|
|
||||||
or this to validate all the VMs:
|
or this to validate all the VMs:
|
||||||
|
|
||||||
-------------------------------------------------
|
-------------------------------------------------
|
||||||
mvn -Dtests.vagrant=all -Psmoke-vms -pl qa/vagrant verify
|
mvn -Dtests.vagrant=all -Psmoke-vms -pl qa/vagrant verify
|
||||||
-------------------------------------------------
|
-------------------------------------------------
|
||||||
|
|
||||||
That will start up the VMs and then immediate quit.
|
That will start up the VMs and then immediate quit.
|
||||||
|
|
||||||
. Finally run the tests. The fastest way to get this started is to run:
|
. Finally run the tests. The fastest way to get this started is to run:
|
||||||
|
|
||||||
-----------------------------------
|
-----------------------------------
|
||||||
mvn clean install -DskipTests
|
mvn clean install -DskipTests
|
||||||
mvn -Dtests.vagrant -pl qa/vagrant verify
|
mvn -Dtests.vagrant -pl qa/vagrant verify
|
||||||
-----------------------------------
|
-----------------------------------
|
||||||
|
|
||||||
You could just run:
|
You could just run:
|
||||||
|
|
||||||
--------------------
|
--------------------
|
||||||
mvn -Dtests.vagrant verify
|
mvn -Dtests.vagrant verify
|
||||||
--------------------
|
--------------------
|
||||||
|
|
||||||
but that will run all the tests. Which is probably a good thing, but not always
|
but that will run all the tests. Which is probably a good thing, but not always
|
||||||
what you want.
|
what you want.
|
||||||
|
|
||||||
|
@ -379,39 +392,51 @@ packaging and SyvVinit and systemd.
|
||||||
|
|
||||||
You can control the boxes that are used for testing like so. Run just
|
You can control the boxes that are used for testing like so. Run just
|
||||||
fedora-22 with:
|
fedora-22 with:
|
||||||
|
|
||||||
--------------------------------------------
|
--------------------------------------------
|
||||||
mvn -Dtests.vagrant -pl qa/vagrant verify -DboxesToTest=fedora-22
|
mvn -Dtests.vagrant -pl qa/vagrant verify -DboxesToTest=fedora-22
|
||||||
--------------------------------------------
|
--------------------------------------------
|
||||||
|
|
||||||
or run wheezy and trusty:
|
or run wheezy and trusty:
|
||||||
|
|
||||||
------------------------------------------------------------------
|
------------------------------------------------------------------
|
||||||
mvn -Dtests.vagrant -pl qa/vagrant verify -DboxesToTest='wheezy, trusty'
|
mvn -Dtests.vagrant -pl qa/vagrant verify -DboxesToTest='wheezy, trusty'
|
||||||
------------------------------------------------------------------
|
------------------------------------------------------------------
|
||||||
|
|
||||||
or run all the boxes:
|
or run all the boxes:
|
||||||
|
|
||||||
---------------------------------------
|
---------------------------------------
|
||||||
mvn -Dtests.vagrant=all -pl qa/vagrant verify
|
mvn -Dtests.vagrant=all -pl qa/vagrant verify
|
||||||
---------------------------------------
|
---------------------------------------
|
||||||
|
|
||||||
Its important to know that if you ctrl-c any of these `mvn` runs that you'll
|
Its important to know that if you ctrl-c any of these `mvn` runs that you'll
|
||||||
probably leave a VM up. You can terminate it by running:
|
probably leave a VM up. You can terminate it by running:
|
||||||
|
|
||||||
------------
|
------------
|
||||||
vagrant halt
|
vagrant halt
|
||||||
------------
|
------------
|
||||||
|
|
||||||
This is just regular vagrant so you can run normal multi box vagrant commands
|
This is just regular vagrant so you can run normal multi box vagrant commands
|
||||||
to test things manually. Just run:
|
to test things manually. Just run:
|
||||||
|
|
||||||
---------------------------------------
|
---------------------------------------
|
||||||
vagrant up trusty && vagrant ssh trusty
|
vagrant up trusty && vagrant ssh trusty
|
||||||
---------------------------------------
|
---------------------------------------
|
||||||
|
|
||||||
to get an Ubuntu or
|
to get an Ubuntu or
|
||||||
|
|
||||||
-------------------------------------------
|
-------------------------------------------
|
||||||
vagrant up centos-7 && vagrant ssh centos-7
|
vagrant up centos-7 && vagrant ssh centos-7
|
||||||
-------------------------------------------
|
-------------------------------------------
|
||||||
|
|
||||||
to get a CentOS. Once you are done with them you should halt them:
|
to get a CentOS. Once you are done with them you should halt them:
|
||||||
|
|
||||||
-------------------
|
-------------------
|
||||||
vagrant halt trusty
|
vagrant halt trusty
|
||||||
-------------------
|
-------------------
|
||||||
|
|
||||||
These are the linux flavors the Vagrantfile currently supports:
|
These are the linux flavors the Vagrantfile currently supports:
|
||||||
|
|
||||||
* precise aka Ubuntu 12.04
|
* precise aka Ubuntu 12.04
|
||||||
* trusty aka Ubuntu 14.04
|
* trusty aka Ubuntu 14.04
|
||||||
* vivid aka Ubuntun 15.04
|
* vivid aka Ubuntun 15.04
|
||||||
|
@ -424,23 +449,29 @@ These are the linux flavors the Vagrantfile currently supports:
|
||||||
|
|
||||||
We're missing the following from the support matrix because there aren't high
|
We're missing the following from the support matrix because there aren't high
|
||||||
quality boxes available in vagrant atlas:
|
quality boxes available in vagrant atlas:
|
||||||
|
|
||||||
* sles-11
|
* sles-11
|
||||||
* sles-12
|
* sles-12
|
||||||
* opensuse-13
|
* opensuse-13
|
||||||
* oel-6
|
* oel-6
|
||||||
|
|
||||||
We're missing the follow because our tests are very linux/bash centric:
|
We're missing the follow because our tests are very linux/bash centric:
|
||||||
|
|
||||||
* Windows Server 2012
|
* Windows Server 2012
|
||||||
|
|
||||||
Its important to think of VMs like cattle: if they become lame you just shoot
|
Its important to think of VMs like cattle: if they become lame you just shoot
|
||||||
them and let vagrant reprovision them. Say you've hosed your precise VM:
|
them and let vagrant reprovision them. Say you've hosed your precise VM:
|
||||||
|
|
||||||
----------------------------------------------------
|
----------------------------------------------------
|
||||||
vagrant ssh precise -c 'sudo rm -rf /bin'; echo oops
|
vagrant ssh precise -c 'sudo rm -rf /bin'; echo oops
|
||||||
----------------------------------------------------
|
----------------------------------------------------
|
||||||
|
|
||||||
All you've got to do to get another one is
|
All you've got to do to get another one is
|
||||||
|
|
||||||
----------------------------------------------
|
----------------------------------------------
|
||||||
vagrant destroy -f trusty && vagrant up trusty
|
vagrant destroy -f trusty && vagrant up trusty
|
||||||
----------------------------------------------
|
----------------------------------------------
|
||||||
|
|
||||||
The whole process takes a minute and a half on a modern laptop, two and a half
|
The whole process takes a minute and a half on a modern laptop, two and a half
|
||||||
without vagrant-cachier.
|
without vagrant-cachier.
|
||||||
|
|
||||||
|
@ -450,14 +481,17 @@ around it:
|
||||||
https://github.com/mitchellh/vagrant/issues/4479
|
https://github.com/mitchellh/vagrant/issues/4479
|
||||||
|
|
||||||
Some vagrant commands will work on all VMs at once:
|
Some vagrant commands will work on all VMs at once:
|
||||||
|
|
||||||
------------------
|
------------------
|
||||||
vagrant halt
|
vagrant halt
|
||||||
vagrant destroy -f
|
vagrant destroy -f
|
||||||
------------------
|
------------------
|
||||||
|
|
||||||
|
|
||||||
----------
|
----------
|
||||||
vagrant up
|
vagrant up
|
||||||
----------
|
----------
|
||||||
|
|
||||||
would normally start all the VMs but we've prevented that because that'd
|
would normally start all the VMs but we've prevented that because that'd
|
||||||
consume a ton of ram.
|
consume a ton of ram.
|
||||||
|
|
||||||
|
@ -466,10 +500,13 @@ consume a ton of ram.
|
||||||
In general its best to stick to testing in vagrant because the bats scripts are
|
In general its best to stick to testing in vagrant because the bats scripts are
|
||||||
destructive. When working with a single package its generally faster to run its
|
destructive. When working with a single package its generally faster to run its
|
||||||
tests in a tighter loop than maven provides. In one window:
|
tests in a tighter loop than maven provides. In one window:
|
||||||
|
|
||||||
--------------------------------
|
--------------------------------
|
||||||
mvn -pl distribution/rpm package
|
mvn -pl distribution/rpm package
|
||||||
--------------------------------
|
--------------------------------
|
||||||
|
|
||||||
and in another window:
|
and in another window:
|
||||||
|
|
||||||
----------------------------------------------------
|
----------------------------------------------------
|
||||||
vagrant up centos-7 && vagrant ssh centos-7
|
vagrant up centos-7 && vagrant ssh centos-7
|
||||||
cd $RPM
|
cd $RPM
|
||||||
|
@ -477,6 +514,7 @@ sudo bats $BATS/*rpm*.bats
|
||||||
----------------------------------------------------
|
----------------------------------------------------
|
||||||
|
|
||||||
If you wanted to retest all the release artifacts on a single VM you could:
|
If you wanted to retest all the release artifacts on a single VM you could:
|
||||||
|
|
||||||
-------------------------------------------------
|
-------------------------------------------------
|
||||||
# Build all the distributions fresh but skip recompiling elasticsearch:
|
# Build all the distributions fresh but skip recompiling elasticsearch:
|
||||||
mvn -amd -pl distribution install -DskipTests
|
mvn -amd -pl distribution install -DskipTests
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue