🛠️ Troubleshooting & FAQ

This page helps you resolve common issues with deploying and using the Azure Landing Zone, DevTest Lab, blockchain network, and CI/CD pipelines.

---

🚩 Common Issues

1. Deployment Fails with Parameter Errors

• Cause: Missing or misconfigured parameter files.
• Solution: Double-check your parameter JSONs and environment variables. See Configuration.

2. Azure CLI Authentication Fails

• Solution: Make sure you’ve run az login and selected the right subscription.
• Tip: If using GitHub Actions, verify your OIDC or PAT secrets.

3. Smart Contract Compilation/Test Fails

• Cause: Outdated dependencies or misconfigured .env.
• Solution: Run npm install in smart-contracts/ and verify all environment variables are set.

4. CI/CD Workflow Not Triggering

• Solution: Ensure you are pushing to the correct branch (main by default). Workflows are located in .github/workflows/.

5. Resource Name Conflicts

• Solution: Update parameter files or Bicep variables to use unique names per environment.

---

💡 FAQ

Q: Can I use a different Azure region?
A: Yes! Update the location parameter in your parameter JSONs and Bicep files.

Q: Where are secrets stored?
A: In Azure Key Vault for infrastructure, and as GitHub Secrets for CI/CD.

Q: How do I customize VM sizes or node counts?
A: Update the respective parameters in your Bicep or parameter files.

Q: Who do I contact for help?
A: Open a GitHub Discussion or Issue.

---

🪧 Still Stuck?

• Review the Playbook and DevTest Lab Security for detailed deployment steps.
• Feel free to contribute solutions to this page!

---

Last updated: 2025-06-16