Proof of value (POV) prerequisites
Before starting a Moderne DX proof of value, your team will need to:
- Set up source control access
- Prepare a repository list
This page covers everything you need to do so nothing is missed on day one.
Checklist
| # | Requirement | Details |
|---|---|---|
| 1 | SCM service account with read access to all in-scope repositories | Used by the CLI and mass ingest to clone and build repositories |
| 2 | SCM OAuth application (GitHub App, GitLab OAuth, etc.) | Allows users to commit changes through the Moderne CLI |
| 3 | Repository list (repos.csv) | Generated with our repository fetcher scripts |
Source control access
You will need a source control management (SCM) service account with read access to all in-scope repositories. This is used by the Moderne CLI and mass ingest to clone repositories and build LSTs. Credentials are mounted at runtime and never baked into images. The mass ingest source control credentials documentation has setup details.
Preparing your repository list
You will need a repos.csv file that lists the repositories to work with. The more repositories you include, the more value you will see from the POV — Moderne's strength is working across repositories at scale.
The easiest way to generate this file is with our repository fetcher scripts, which are available for GitHub, GitLab, Bitbucket (Data Center and Cloud), and Azure DevOps. These scripts query your SCM's API and produce a ready-to-use repos.csv file.
Mass ingest
While mass ingest is typically set up after the initial POV rather than during it, you may want to plan for it early. Mass ingest builds all of your repositories and creates the LST artifacts that recipes run against. It runs as a Docker container.
| Resource | Minimum |
|---|---|
| CPU | 2 cores |
| Memory | 16 GB |
| Disk | 32 GB |
These resources are sufficient for up to ~1,000 repositories. For larger organizations, mass ingest can be scaled using cloud batch services like AWS Batch, Google Cloud Batch, or Azure Batch. See the mass ingest documentation for detailed setup instructions.
If you have a standard base image that includes your existing certificates or other configuration, we can build on top of that. If you don't, we'll build from standard open-source base images and configure it with any certificates, credentials, and build tool settings during the engagement.
What Moderne provides
During the POV process, Moderne will provide:
- A Moderne CLI license for running recipes across your repositories
- Technical support throughout the setup and evaluation process
Next steps
Once these prerequisites are in place, proceed to the proof of value process to start running recipes against your code.