README.md #6

  • //
  • guest/
  • perforce_software/
  • sdp/
  • main/
  • test/
  • README.md
  • Markdown
  • View
  • Commits
  • Open Download .zip Download (2 KB)

Welcome

This is a test harness for the Perforce Unix SDP (Server Deployment Package). It used to use Vagrant, but has now been converted to use Docker containers (see older versions of this file for Vagrant instructions).

Requirements

To use this bundle you will need to download and install the following free tool:

https://docs.docker.com/engine/installation/

If you're not familiar with Docker, it is building up a huge momentum because of its sweet spot functionality which addresses fast creation of virtual environments and the ability to ship images with all dependencies between different environments.

https://docs.docker.com/mac/

Usage

1) Have a workspace which looks like (assuming name of myws.sdp):

View:
    //guest/perforce_software/sdp/main/... //myws.sdp/sdp/...
    //guest/perforce_software/sdp/main/test/* //myws.sdp/*

2) sync the workspace

3) From the command prompt run run_docker_tests.sh from the root directory. The first time you run it will take a while as it builds the initial docker images!

Workflow for testing

Build your docker image (from workspace root):

1) docker build --rm=true -t=ubuntu-sdp -f sdp/test/docker/Dockerfile.centos6.sdp sdp/test/docker

How to run all tests:

1) docker run --rm -v pwd/sdp:/sdp centos6-sdp /p4/docker_entry.sh

How to interactively poke around inside the container:

1) docker run --rm -v pwd/sdp:/sdp -it centos6-sdp /bin/bash 2) Run 'sudo su - perforce' to become user perforce (home directory is /p4) 3) /p4/test_sdp.sh

Substitute 'centos' for 'ubuntu' for different distribution in above commands.

Welcome
=======
This is a test harness for the Perforce Unix SDP (Server Deployment Package). 
It used to use Vagrant, but has now been converted to use Docker containers (see older
versions of this file for Vagrant instructions).

Requirements
------------
To use this bundle you will need to download and install the following free tool:

https://docs.docker.com/engine/installation/

If you're not familiar with Docker, it is building up a huge momentum because of its
sweet spot functionality which addresses fast creation of virtual environments and
the ability to ship images with all dependencies between different environments.

https://docs.docker.com/mac/

Usage
-----
1) Have a workspace which looks like (assuming name of myws.sdp):   

    View:
        //guest/perforce_software/sdp/main/... //myws.sdp/sdp/...
        //guest/perforce_software/sdp/main/test/* //myws.sdp/*

2) sync the workspace

3) From the command prompt run run_docker_tests.sh from the root directory. The first time 
you run it will take a while as it builds the initial docker images!

Workflow for testing
--------------------

Build your docker image (from workspace root):

1) docker build --rm=true -t=ubuntu-sdp -f sdp/test/docker/Dockerfile.centos6.sdp sdp/test/docker

How to run all tests:

1) docker run --rm -v `pwd`/sdp:/sdp centos6-sdp /p4/docker_entry.sh

How to interactively poke around inside the container:

1) docker run --rm -v `pwd`/sdp:/sdp -it centos6-sdp /bin/bash
2) Run 'sudo su - perforce' to become user perforce (home directory is /p4)
3) /p4/test_sdp.sh

Substitute 'centos' for 'ubuntu' for different distribution in above commands.
# Change User Description Committed
#10 27331 C. Thomas Tyler Released SDP 2020.1.27325 (2021/01/29).
Copy Up using 'p4 copy -r -b perforce_software-sdp-dev'.
#9 25483 C. Thomas Tyler Released SDP 2019.1.25480 (2019/04/11).
Copy Up using 'p4 copy -r -b perforce_software-sdp-dev'.
#8 25245 C. Thomas Tyler Released SDP 2019.1.25238 (2019/03/02).
Copy Up using 'p4 copy -r -b perforce_software-sdp-dev'.
#7 25012 Robert Cowham Propagate test updates from dev and fix failing test by also propagating deleted script.
#6 20974 C. Thomas Tyler Released SDP 2016.2.20972 (2016/11/01).
Copy Up using 'p4 copy -r -b perforce_software-sdp-dev'.
#5 19322 Robert Cowham Propagate Docker tests to Main.
No functional change.
#4 13587 C. Thomas Tyler Copy up of recent minor dev branch changes to auxiliary scripts
and comments.  No core SDP functionality changes.
#3 11828 Robert Cowham Clarify paths and instructions for testing.
#2 10459 Robert Cowham Fix test comments regarding workspace setup for Workshop location
Tidy Vangrantfile comments
#review
#1 10148 C. Thomas Tyler Promoted the Perforce Server Deployment Package to The Workshop.