"Fossies" - the Fresh Open Source Software Archive

Member "apache-pulsar-2.6.0/dev/README.md" (9 Jun 2020, 2308 Bytes) of package /linux/misc/apache-pulsar-2.6.0-src.tar.gz:


As a special service "Fossies" has tried to format the requested source page into HTML format (assuming markdown format). Alternatively you can here view or download the uninterpreted source code file. A member file download can also be achieved by clicking within a package contents listing on the according byte size field. See also the last Fossies "Diffs" side-by-side code changes report for "README.md": 2.4.2_vs_2.5.0.

Apache Pulsar Dev Tools

Running Integration Tests on macOS

Currently all the integration tests are docker based and written using testcontainers framework. Due to the networking issues, the integration tests can only be run on linux environment. For people who is using macOS as their development environment, you can use Vagrant to launch a linux virtual machine and run the integration tests there.

  1. Download and Install Vagrant.

  2. Provision and launch the dev vm.

    $ cd ${PULSAR_HOME}/dev
    
    # provision the vm
    $ vagrant up
  3. The dev vm will try to mount your current pulsar workspace to be under /pulsar in the vm. You might potentially hit following errors due to fail to install VirtualBox Guest additions.

    /sbin/mount.vboxsf: mounting failed with the error: No such device

    If that happens, follow the below instructions:

     $ vagrant plugin install vagrant-vbguest
     $ vagrant destroy && vagrant up
    
    # reload the vm
    $ vagrant reload
  4. Now, you will have a pulsar dev vm ready for running integration tests.

    $ vagrant ssh
    
    # once you are in the pulsar dev vm, you can launch docker.
    [vagrant@bogon pulsar]$ sudo systemctl start docker
    
    # your pulsar workspace will be mount under /pulsar
    [vagrant@bogon pulsar]$ cd /pulsar
    
    # you can build and test using maven commands