nateduff/n8k8

Getting Started

Prerequesits

1. Dotnet 8 SDK & Aspire Workloads (minimum: 8.0.0-preview.7.24251.11/8.0.100)
2. Node v.16 Minimum
3. Docker Desktop with Kubernetes Enabled

Setup

## Install Aspire workload (update if necessary with dotnet workload update)
dotnet workload install aspire

## Install AZD CLI
winget install microsoft.azd

## Restore packages
dotnet restore

## Web project NPM installs
CD .\web

npm install

npm run buildcss ## optional file watcher with npm run buildcss-watch

## Local user secret setup
CD ..\.aspire\N8.Aspire.AppHost\

dotnet user-secrets set Parameters:messaging "{{REDACTED}}"

## Azure development environment setup
CD ..\..\

azd env new "{{ENVNAME}}"
#azd env select "{{ENVNAME}}" ## only needed after first env
azd env set AZURE_MESSAGING "{{REDACTED}}"

Build

## Builds container images
.\build.ps1

Run (K8s)

## Starts all deployments & services
.\run.ps1

Delete K8s Resources

## Deletes everything in K8s
kubectl delete all --all

Release via AZD CLI

azd up

Architecture

Web

• Interactive Blazor Server application used to demonstrate tailwindcss UI components, API interactivity, message consumption via rabbitMQ, & real time server/client communication via SignalR.

API

• Minimal API with sample TODO's endpoint.

Worker

• Background service publishing RabbitMQ messages every 3 seconds.

Jobs

• On demand kubernetes job examples for a dotnet console & Azure PowerShell application.

Others

Aspire

• Used for local development of micro-services.

K8s

• Houses all kubernetes deployment & service YAML definitions.