AZPrototype/getting-started.html at main · Bird-NZ/AZPrototype · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Getting started · AZPrototype</title>
  <meta name="description" content="Prerequisites, install steps, and first-run checks for AZ Prototype.">
  <link rel="stylesheet" href="assets/style.css">
  <script defer src="assets/site.js"></script>
</head>
<body>
  <div class="shell">
    <aside class="sidebar">
      <a class="brand" href="index.html">
        <span class="brand-mark">AZ</span>
        <span><strong>AZPrototype</strong><small>GitHub Pages docs site</small></span>
      </a>
      <nav class="nav"><a href="index.html" class="nav-link">Overview</a><a href="getting-started.html" class="nav-link active">Getting started</a><a href="quickstart.html" class="nav-link">Quickstart</a><a href="walkthrough.html" class="nav-link">Walkthrough</a><a href="artifacts.html" class="nav-link">Artifacts</a><a href="agents.html" class="nav-link">Agents</a><a href="templates.html" class="nav-link">Templates</a><a href="configuration.html" class="nav-link">Configuration</a><a href="deployment.html" class="nav-link">Deployment</a><a href="troubleshooting.html" class="nav-link">Troubleshooting</a><a href="examples.html" class="nav-link">Examples</a><a href="faq.html" class="nav-link">FAQ</a></nav>
      <div class="sidebar-note">
        <p><strong>Workflow</strong></p>
        <p><code>init → design → build → deploy</code></p>
      </div>
    </aside>
    <main class="content">
      <header class="hero">
        <p class="eyebrow">AZ Prototype Docs</p>
        <h1>Getting started</h1>
        <p class="lede">Prerequisites, install steps, and first-run checks for AZ Prototype.</p>

      </header>

<section class="panel"><h2>Prerequisites</h2><ul><li>Azure CLI 2.50 or newer</li><li>An Azure subscription you can deploy into</li><li><code>gh</code> installed and authenticated if using <code>copilot</code> or <code>github-models</code></li><li>A GitHub Copilot Business or Enterprise license if using the <code>copilot</code> provider</li><li>Terraform or Bicep available when you reach build/deploy for that chosen IaC path</li></ul></section>
<section class="grid cols-2"><article class="panel"><h2>Install</h2><pre><code>az extension add --name prototype
# later
az extension update --name prototype --allow-preview</code></pre><p>The extension auto-installs on first use too, but explicit install makes onboarding cleaner.</p></article><article class="panel"><h2>Sanity checks</h2><pre><code>az --version
az account show
gh auth status
az prototype --help</code></pre><p>Run these before your first workshop or demo so authentication issues do not eat the whole session.</p></article></section>
<section class="panel"><h2>Choose your AI provider</h2><table><tr><th>Provider</th><th>Best when</th><th>Notes</th></tr><tr><td><code>copilot</code></td><td>You want GitHub Copilot-backed generation</td><td>Requires <code>gh</code> auth and Copilot licensing</td></tr><tr><td><code>github-models</code></td><td>You want GitHub-hosted model access</td><td>Also uses GitHub auth</td></tr><tr><td><code>azure-openai</code></td><td>You want Azure-native model routing</td><td>Skips GitHub auth path</td></tr></table></section>
<section class="panel"><h2>First-run advice</h2><ul><li>Use a fresh directory for each prototype project.</li><li>Pick one IaC tool up front so your demos stay consistent.</li><li>Use preview-friendly language in docs and stakeholder demos because the extension is explicitly in preview.</li></ul></section>

      <footer class="footer">
        <p>Built as a static, GitHub Project Pages-ready site for the <code>az prototype</code> extension.</p>
      </footer>
    </main>
  </div>
</body>
</html>