references/scan.md
Codebase Scan
Analyze workspace to identify components, technologies, and dependencies.
Detection Patterns
Languages & Frameworks
| File | Indicates |
|------|-----------|
| package.json | Node.js |
| requirements.txt, pyproject.toml | Python |
| *.csproj, *.sln | .NET |
| pom.xml, build.gradle | Java |
| go.mod | Go |
Component Types
| Pattern | Component Type | |---------|----------------| | React/Vue/Angular in package.json | SPA Frontend | | Only .html/.css/.js files, no package.json | Pure Static Site | | Express/Fastify/Koa | API Service | | Flask/FastAPI/Django | API Service | | Next.js/Nuxt | SSR Web App | | Celery/Bull/Agenda | Background Worker | | azure-functions SDK | Azure Function | | .AppHost.csproj or Aspire.Hosting package | .NET Aspire App |
Pure Static Site Detection:
- No package.json, requirements.txt, or build configuration
- Contains only HTML, CSS, JavaScript, and asset files
- No framework dependencies (React, Vue, Angular, etc.)
- ⚠️ For pure static sites, do NOT add
languagefield to azure.yaml to avoid triggering build steps
Existing Tooling
| Found | Tooling |
|-------|---------|
| azure.yaml | AZD configured |
| infra/*.bicep | Bicep IaC |
| infra/*.tf | Terraform IaC |
| Dockerfile | Containerized |
| .github/workflows/ | GitHub Actions CI/CD |
| azure-pipelines.yml | Azure DevOps CI/CD |
.NET Aspire Detection
.NET Aspire projects are identified by:
- A project ending with
.AppHost.csproj(e.g.,OrleansVoting.AppHost.csproj) - Reference to
Aspire.HostingorAspire.Hosting.AppHostpackage in .csproj files - Multiple .NET projects in a solution, typically including an AppHost orchestrator
When Aspire is detected:
- Use
azd init --from-code -e <environment-name>instead of manual azure.yaml creation - The
--from-codeflag automatically detects the AppHost and generates appropriate configuration - The
-eflag is required for non-interactive environments (agents, CI/CD) - ⚠️ CRITICAL: If the AppHost contains
AddAzureFunctionsProject, you MUST add.WithEnvironment("AzureWebJobsSecretStorageType", "Files")to the Functions builder chain BEFORE deployment. Without this, Functions will fail at startup withSecret initialization from Blob storage failed. See aspire.md Step 4b for the complete detection and fix procedure. - See aspire.md for detailed Aspire-specific guidance
Output
Document findings:
## Components
| Component | Type | Technology | Path |
|-----------|------|------------|------|
| api | API Service | Node.js/Express | src/api |
| web | SPA | React | src/web |
| worker | Background | Python | src/worker |
## Dependencies
| Component | Depends On | Type |
|-----------|-----------|------|
| api | PostgreSQL | Database |
| web | api | HTTP |
| worker | Service Bus | Queue |
## Existing Infrastructure
| Item | Status |
|------|--------|
| azure.yaml | Not found |
| infra/ | Not found |
| Dockerfiles | Found: src/api/Dockerfile |