docs/testing/local-ci-build.md

13 `sudo docker run hello-world`.
26 git clone https://github.com/openbmc/openbmc-build-scripts.git
29 ## Add a Read-Only Repo
33 clones and builds phosphor-hwmon directly. The upstream CI will try building
35 `format-code.sh` and check if the code is formatted properly if there is a
36 `.clang-format` file present in the target repository, or if there is a script
37 in the repo named `format-code.sh`.
41 git clone https://github.com/openbmc/phosphor-hwmon
42 WORKSPACE=$(pwd) UNIT_TEST_PKG=phosphor-hwmon \
43 ./openbmc-build-scripts/run-unit-test-docker.sh
46 NOTE: When running 'run-unit-test-docker.sh' make sure you do not have any
47 uncommitted changes. The script runs git diff after 'format-code.sh' and
65 WORKSPACE=$(pwd) UNIT_TEST_PKG=phosphor-hwmon NO_FORMAT_CODE=1 \
66 ./openbmc-build-scripts/run-unit-test-docker.sh
69 `NO_FORMAT_CODE=1` tells the script to skip the `format-code.sh` so that it will
70 not format the code and thus your repo could contain un-committed changes.
80 WORKSPACE=$(pwd) UNIT_TEST_PKG=phosphor-hwmon TEST_ONLY=1 \
81 ./openbmc-build-scripts/run-unit-test-docker.sh
91 This example demonstrates how to make a worktree of `phosphor-host-ipmid` in
95 cd /my/dir/for/phosphor-host-ipmid
96 git worktree add /path/to/ci_test_area/phosphor-host-ipmid
100 `phosphor-host-ipmid/`, and if you enter it and run `git status` you will see
101 that you're likely on a new branch named `phosphor-host-ipmid`. This is just for
106 (`/my/dir/for/phosphor-host-ipmid`), so we'll need to mount it when we run. Open
107 up `/path/to/ci_test_area/openbmc-build-scripts/run-unit-test-docker.sh` and
112 PHOSPHOR_IPMI_HOST_PATH="/my/dir/for/phosphor-host-ipmid"
114 docker run --blah-blah-existing-flags \
115   -v ${PHOSPHOR_IPMI_HOST_PATH}:${PHOSPHOR_IPMI_HOST_PATH} \
116   -other \
117   -args
124 cd openbmc-build-scripts
125 git add run-unit-test-docker.sh
126 git commit -m "mount phosphor-host-ipmid"
133 cd /my/dir/for/phosphor-host-ipmid
134 git checkout -b add-foo
139 git commit -sm "change foo"
141 cd /path/to/ci_test_area/phosphor-host-ipmid
142 git checkout --detach add-foo
149 `run-unit-test-docker.sh` which will drop you into a bash shell with a default
150 D-Bus instance. This is handy if you need to run gdb on a core dump or run a