MIT License
Welcome to the Arc Jumpstart Apps source code repository! This repository is your go-to resource for all the Jumpstart applications/charts/containers used across the different Jumsptart products. Use this repository with the complement of our documentation repository that eventually populates the Arc Jumpstart website.
This source code repository is designed with contributors in mind and works in tandem with the our documentation repository. While it's not mandatory, it's highly likely that contributors will need to clone both repositories to effectively contribute to Arc Jumpstart.
Before you start, we recommend familiarizing yourself with our comprehensive contribution guidelines. These guidelines outline the standards and practices we follow, ensuring consistency and quality across our documentation.
If you're unsure about your future contribution, don't hesitate to start a GitHub discussion. This is a great place to ask questions, share ideas, or get feedback on potential contributions. Our community is here to help and we welcome all levels of experience.
Happy contributing!
Follow these guidelines for submitting your code to the Jumpstart project repository.
The top-level folder should represent the product name. The available product folders are:
Folder | Product Documentation |
---|---|
agora | Jumpstart Agora |
scenarios | Jumpstart Scenarios |
hcibox | Jumpstart HCIBox |
arcbox | Jumpstart ArcBox |
drops | Jumpstart Drops |
[!NOTE] Jumpstart Drops artifacts should be stored in the Drops repository.
The second-level folder represents the subproduct, with the following considerations:
contoso_bakeries
, esa_fault_detection
).Each subproduct folder should have the following subfolders:
![NOTE] If required, you can add extra folders for other artifacts, such as scripts or images.
Example Folder Structure:
agora/
footfall_ai_api/
src/
Docker.manufacturing # Points to mcr.microsoft.com/Jumpstart/Agora/footfall_ai_api:manufacturing
Docker.healthcare # Points to mcr.microsoft.com/Jumpstart/Agora/footfall_ai_api:healthcare
operations/
helm/ # Helm charts should point to mcr.microsoft.com/Jumpstart/Agora/footfall_ai_api:{value-scenario}
artifacts/ # Store non-code files like videos or documents here.
pose_estimator_ai_api/
main_ui/
mqtt_simulator/
src/
main-supermarket.py
main-manufacturing.py
main-bakeries.py
Dockerfile # Dockerfile to handle builds for various environments.
operations/
...
arcbox/
hello_arc/
bookstore/
scenarios/
contoso_bakeries/
mqtt_simulator/
esa_fault_detection/
For example, in teh case of the footfall_ai_api
container, the Dockerfile should push to specific tags:
mcr.microsoft.com/Jumpstart/Agora/footfall_ai_api:manufacturing
mcr.microsoft.com/Jumpstart/Agora/footfall_ai_api:healthcare
Prepare your PR:
Review: Submit the PR for review. Well review your Dockerfiles and other artifacts before merging.
Canary Pipeline: Once your PR is merged, the pipeline will:
:canary
tag.Main Pipeline: After successful validation, the process is repeated for the main
branch and production containers.
By following these guidelines, you will ensure a smooth submission process and maintain consistency across all products and scenarios.
The Jumpstart Apps repository handles branching similarly to the other Arc Jumpstart repositories. Two primary branches are maintained, each one attached to a specific purpose: development or production.
The following branches are currently maintained:
Branch | Description |
---|---|
main (primary) | Latest publicly available Arc Jumpstart Aps artiafacts. This is the latest documentation and deployment scripts available. |
canary (preview) | Pre-release artifacts and documentation. Document and code updates should be merged to the canary branch for preview validation before merging to the main branch. |
This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines.
Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.