1# Azure App Service
2 
3Hosting patterns and best practices for Azure App Service.
4 
5## When to Use
6 
7- Traditional web applications
8- REST APIs without containerization
9- .NET, Node.js, Python, Java, PHP applications
10- When Docker is not required/desired
11- When built-in deployment slots are needed
12 
13## Service Type in azure.yaml
14 
15```yaml
16services:
17  my-web:
18    host: appservice
19    project: ./src/my-web
20```
21 
22## Required Supporting Resources
23 
24| Resource | Purpose |
25|----------|---------|
26| App Service Plan | Compute hosting |
27| Application Insights | Monitoring |
28| Key Vault | Secrets (optional) |
29 
30## Runtime Stacks
31 
32> 💡 **Tip:** Prefer Linux App Service Plans for Node.js, Python, and Java. Use Windows only when explicitly required (e.g. .NET Framework). See [Bicep Patterns](bicep.md) for Linux vs Windows configuration.
33 
34### Linux (recommended)
35 
36| Language | linuxFxVersion |
37|----------|----------------|
38| Node.js 18 | `NODE\|18-lts` |
39| Node.js 20 | `NODE\|20-lts` |
40| Python 3.11 | `PYTHON\|3.11` |
41| .NET 8 | `DOTNETCORE\|8.0` |
42| Java 17 | `JAVA\|17-java17` |
43 
44### Windows
45 
46| Language | Setting |
47|----------|---------|
48| Node.js | `WEBSITE_NODE_DEFAULT_VERSION: '~20'` (app setting) |
49| .NET 8 | Built-in (no extra config) |
50 
51## SKU Selection
52 
53| SKU | Use Case |
54|-----|----------|
55| F1/D1 | Development/testing (free/shared) |
56| B1-B3 | Small production, basic features |
57| S1-S3 | Production with auto-scale, slots |
58| P1v3-P3v3 | High-performance production |
59 
60## Health Checks
61 
62Always configure health check path:
63 
64```bicep
65siteConfig: {
66  healthCheckPath: '/health'
67}
68```
69 
70Endpoint should return 200 OK when healthy.
71 
72## Templates
73 
74For App Service templates with composable recipes (SQL, Cosmos DB, Auth, Redis), see [Template Selection](templates/selection.md).
75 
76## Common Data Backends
77 
78When pairing App Service with a data layer, load the corresponding service references:
79 
80| Data Service | Reference                                 |
81| ------------ | ----------------------------------------- |
82| Azure SQL    | [SQL Database](../sql-database/README.md) |
83| Cosmos DB    | [Cosmos DB](../cosmos-db/README.md)       |
84 
85## References
86 
87- [Bicep Patterns](bicep.md)
88- [Deployment Slots](deployment-slots.md)
89- [Auto-Scaling](scaling.md)
90- [Networking](networking.md)
91- [SKU Selection](sku-selection.md)
92- [Custom Domains](custom-domains.md)
93