From: "Michael Kubacki" <mikuback@linux.microsoft.com>
To: devel@edk2.groups.io
Cc: Sean Brogan <sean.brogan@microsoft.com>,
Michael D Kinney <michael.d.kinney@intel.com>,
Liming Gao <gaoliming@byosoft.com.cn>
Subject: [PATCH v1 1/5] .pytool/Readme.md: Add reference to new build instructions
Date: Mon, 5 Dec 2022 12:28:35 -0500 [thread overview]
Message-ID: <20221205172839.2859-2-mikuback@linux.microsoft.com> (raw)
In-Reply-To: <20221205172839.2859-1-mikuback@linux.microsoft.com>
From: Michael Kubacki <michael.kubacki@microsoft.com>
Adds a reference to the new build instructions on the TianoCore wiki
that currently describe building with containers and Stuart.
Cc: Sean Brogan <sean.brogan@microsoft.com>
Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <gaoliming@byosoft.com.cn>
Signed-off-by: Michael Kubacki <michael.kubacki@microsoft.com>
---
.pytool/Readme.md | 52 +++++++-------------
1 file changed, 17 insertions(+), 35 deletions(-)
diff --git a/.pytool/Readme.md b/.pytool/Readme.md
index 9c7b7f9abbec..b2688d168753 100644
--- a/.pytool/Readme.md
+++ b/.pytool/Readme.md
@@ -1,5 +1,12 @@
# Edk2 Continuous Integration
+This file focuses on information for those working with the `.pytools` directory
+directly or interested in lower-level details about how CI works.
+
+If you just want to get started building code, visit
+[Build Instructions](https://github.com/tianocore/tianocore.github.io/wiki/Build-Instruction)
+on the TianoCore wiki.
+
## Basic Status
| Package | Windows VS2019 (IA32/X64)| Ubuntu GCC (IA32/X64/ARM/AARCH64) | Known Issues |
@@ -82,43 +89,18 @@ easily and consistently running locally and in a cloud ci environment. To do
that a few steps should be followed. Details of EDKII Tools can be found in the
[docs folder here](https://github.com/tianocore/edk2-pytool-extensions/tree/master/docs)
-### Prerequisites
-
-1. A supported toolchain (others might work but this is what is tested and validated)
- * Windows 10:
- * VS 2017 or VS 2019
- * Windows SDK (for rc)
- * Windows WDK (for capsules)
- * Ubuntu 18.04 or Fedora
- * GCC5
- * Easy to add more but this is the current state
-2. Python 3.7.x or newer on path
-3. git on path
-4. Recommended to setup and activate a python virtual environment
-5. Install the requirements `pip install --upgrade -r pip-requirements.txt`
-
### Running CI
-1. clone your edk2 repo
-2. Activate your python virtual environment in cmd window
-3. Get code dependencies (done only when submodules change)
- * `stuart_setup -c .pytool/CISettings.py TOOL_CHAIN_TAG=<your tag here>`
-4. Update other dependencies (done more often)
- * `stuart_update -c .pytool/CISettings.py TOOL_CHAIN_TAG=<your tag here>`
-5. Run CI build (--help will give you options)
- * `stuart_ci_build -c .pytool/CISettings.py TOOL_CHAIN_TAG=<your tag here>`
- * -p <pkg1,pkg2,pkg3> : To build only certain packages use a CSV list
- * -a <arch1,arch2,arch3>: To run only certain architectures use a CSV list
- * -t <target1,target2>: To run only tests related to certain targets use a
- CSV list
- * By default all tests are opted in. Then given a package.ci.yaml file those
- tests can be configured for a package. Finally setting the check to the
- value `skip` will skip that plugin. Examples:
- * `CompilerPlugin=skip` skip the build test
- * `GuidCheck=skip` skip the Guid check
- * `SpellCheck=skip` skip the spell checker
- * etc
-6. Detailed reports and logs per package are captured in the `Build` directory
+Quick notes:
+
+* By default all CI plugins are opted in.
+ * Setting the plugin to `skip` as an argument will skip running the plugin.
+ Examples:
+ * `CompilerPlugin=skip` skip the build test
+ * `GuidCheck=skip` skip the Guid check
+ * `SpellCheck=skip` skip the spell checker
+ * etc.
+* Detailed reports and logs per package are captured in the `Build` directory.
## Current PyTool Test Capabilities
--
2.28.0.windows.1
next prev parent reply other threads:[~2022-12-05 17:29 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-12-05 17:28 [PATCH v1 0/5] Update references to new edk2 build instructions Michael Kubacki
2022-12-05 17:28 ` Michael Kubacki [this message]
2022-12-05 17:28 ` [PATCH v1 2/5] ArmVirtPkg: Add reference to new " Michael Kubacki
2022-12-05 17:28 ` [PATCH v1 3/5] BaseTools: " Michael Kubacki
2022-12-05 17:28 ` [PATCH v1 4/5] EmulatorPkg: " Michael Kubacki
2022-12-05 17:28 ` [PATCH v1 5/5] OvmfPkg: " Michael Kubacki
2022-12-09 7:00 ` Yao, Jiewen
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-list from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20221205172839.2859-2-mikuback@linux.microsoft.com \
--to=devel@edk2.groups.io \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox