Code Snippets on PAUL'S BLOG

Adding a GitHub Codespace button to your README

Thu, 21 Mar 2024 13:00:00 +0000

GitHub Codespaces is a great way to make it easier for people to contribute to your project. With a few clicks, folks can spin up a Codespace environment with all necessary tooling installed and be productive right away. But it does take a few clicks and this quick post is to show how you can save developers a click or two because every click matters 😆

With one line of markdown in your README, you can add a button that looks like this…

Installing .NET on Ubuntu

Sat, 09 Sep 2023 13:00:00 +0000

Installing .NET on Ubuntu is supposed to be easy. Sometimes it’s not. You should be able to follow the instructions on the Microsoft docs and install from a package manager but I’ve had issues with that. It’s been a frustrating experience; the package installs but then I can’t run dotnet --version and I can’t figure out why.

Thankfully there is an option to manually install .NET, this is what I’ve had the most success with.

Purging Deleted Azure Key Vaults

Mon, 27 Feb 2023 13:09:20 -0800

Do you constantly provision and delete Azure Key Vaults?

If so, you may have noticed attempts to recreate a recently deleted key vault will result in the following error:

The vault name is already in use.

This is because Azure Key Vaults are kept in a deleted state and not automatically purged. You must manually purge these key vaults to be able to reuse the name.

To confirm the key vault in question is in “deleted” state, you can run the following:

Ubuntu Dev Tools

Fri, 11 Nov 2022 06:57:20 -0800

Is this the year of the Linux desktop? I’m not sure but I have been making more of an effort to “daily drive” a Linux desktop lately. I’m currently working off of an Ubuntu 22.10 machine and here is my script for installing common tools that I work with daily.

sudo apt-get update 
sudo apt-get upgrade

# add git repository
sudo add-apt-repository ppa:git-core/ppa

# install some basic tools
sudo apt-get update
sudo apt-get install -y \
 python3 \
 python3-pip \
 bpytop \
 tree \
 guvcview \
 vim \
 curl \
 git \
 gnupg2 \
 jq \
 sudo \
 zsh \
 build-essential \
 cmake \
 libssl-dev \
 openssl \
 unzip \
 pkg-config

# install brew tools
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo '# Set PATH, MANPATH, etc., for Homebrew.' >> /home/paul/.zshrc
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> /home/paul/.zshrc
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
brew install gcc 

# install hugo 
brew install hugo

# install azure cli
curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

# install dotnet6
sudo apt-get install dotnet6

# install go
wget https://go.dev/dl/go1.19.3.linux-amd64.tar.gz
sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf go1.19.3.linux-amd64.tar.gz
echo "export PATH=$PATH:/usr/local/go/bin" >> ~/.zshrc
rm go1.19.3.linux-amd64.tar.gz 

# install kubectl
sudo apt-get update
sudo apt-get install -y ca-certificates curl
sudo curl -fsSLo /usr/share/keyrings/kubernetes-archive-keyring.gpg https://packages.cloud.google.com/apt/doc/apt-key.gpg
echo "deb [signed-by=/usr/share/keyrings/kubernetes-archive-keyring.gpg] https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee /etc/apt/sources.list.d/kubernetes.list
sudo apt-get update
sudo apt-get install -y kubectl

# install docker desktop
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo \
 "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
 $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
wget https://desktop.docker.com/linux/main/amd64/docker-desktop-4.13.1-amd64.deb
sudo apt-get update
sudo apt-get install -y ./docker-desktop-4.13.1-amd64.deb
rm docker-desktop-4.13.1-amd64.deb

# install rancher desktop
curl -s https://download.opensuse.org/repositories/isv:/Rancher:/stable/deb/Release.key | gpg --dearmor | sudo dd status=none of=/usr/share/keyrings/isv-rancher-stable-archive-keyring.gpg
echo 'deb [signed-by=/usr/share/keyrings/isv-rancher-stable-archive-keyring.gpg] https://download.opensuse.org/repositories/isv:/Rancher:/stable/deb/ ./' | sudo dd status=none of=/etc/apt/sources.list.d/isv-rancher-stable.list
sudo apt-get update
sudo apt-get install -y rancher-desktop

# install hashi tools
wget -O- https://apt.releases.hashicorp.com/gpg | gpg --dearmor | sudo tee /usr/share/keyrings/hashicorp-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com jammy main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
sudo apt update
sudo apt-get install -y terraform packer consul nomad vault waypoint

# install node
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # This loads nvm bash_completion
command -v nvm
nvm install 18

# install pulumi
curl -fsSL https://get.pulumi.com | sh

# install rust and toolchains
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
echo "source $HOME/.cargo/env" >> ~/.zshrc
source "$HOME/.cargo/env"
echo "PATH=$PATH:$HOME/.cargo/bin" >> ~/.zshrc
source ~/.zshrc

# install tools for building wasm apps
rustup install nightly
rustup component add rustfmt
rustup component add rustfmt --toolchain nightly
rustup component add clippy
rustup component add clippy --toolchain nightly
cargo install cargo-expand
cargo install cargo-edit
cargo install cargo-generate
cargo install --git https://github.com/bytecodealliance/wit-bindgen wit-bindgen-cli --tag v0.2.0
rustup target add wasm32-wasi
rustup target add wasm32-unknown-unknown

# install rustwasm
curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh

# install wasmtime
curl https://wasmtime.dev/install.sh -sSf | bash

# install snaps
sudo snap install --classic code
sudo snap install spotify
sudo snap install postman
sudo snap install zoom-client
sudo snap install sublime-text --classic
sudo snap install storage-explorer
sudo snap install obs-studio
sudo snap install discord
sudo snap install slack --classic
sudo snap install vlc

Terraform: Azure Container Apps with Azure Managed Grafana using the AzAPI provider

Fri, 09 Sep 2022 06:00:00 -0700

Code snippet for the Monitoring Azure Container Apps With Azure Managed Grafana article.

`main.tf`

terraform {
 required_providers {
 azurerm = {
 source = "hashicorp/azurerm"
 version = ">=3.0.0"
 }

 azapi = {
 source = "azure/azapi"
 version = ">=0.5.0"
 }
 }
}

provider "azurerm" {
 features {
 resource_group {
 prevent_deletion_if_contains_resources = false
 }

 key_vault {
 purge_soft_delete_on_destroy = false
 }
 }
}

resource "random_pet" "aca" {
 length = 2
 separator = ""
}

resource "random_integer" "aca" {
 min = 000
 max = 999
}

resource "random_string" "aca" {
 length = 5
 lower = true
 upper = false
 numeric = true
 special = false

 keepers = {
 # Generate a new random_string on every run to avoid a conflict with the previous revision
 none = timestamp()
 }
}

locals {
 resource_name = format("%s", random_pet.aca.id)
 resource_name_unique = format("%s%s", random_pet.aca.id, random_integer.aca.result)
 location = "eastus"
}

resource "azurerm_resource_group" "aca" {
 name = "rg-${local.resource_name}"
 location = local.location
}

resource "azurerm_log_analytics_workspace" "aca" {
 name = "law-${local.resource_name_unique}"
 resource_group_name = azurerm_resource_group.aca.name
 location = azurerm_resource_group.aca.location
 sku = "PerGB2018"
 retention_in_days = 30
}

# https://docs.microsoft.com//azure/templates/microsoft.app/2022-03-01/managedenvironments?tabs=bicep&pivots=deployment-language-terraform
resource "azapi_resource" "env" {
 type = "Microsoft.App/managedEnvironments@2022-03-01"
 name = "env-${local.resource_name}"
 parent_id = azurerm_resource_group.aca.id
 location = azurerm_resource_group.aca.location

 body = jsonencode({
 properties = {
 appLogsConfiguration = {
 destination = "log-analytics"
 logAnalyticsConfiguration = {
 customerId = azurerm_log_analytics_workspace.aca.workspace_id
 sharedKey = azurerm_log_analytics_workspace.aca.primary_shared_key
 }
 }
 }
 })
}

resource "azapi_resource" "helloworld" {
 type = "Microsoft.App/containerApps@2022-03-01"
 name = "helloworld"
 parent_id = azurerm_resource_group.aca.id
 location = azurerm_resource_group.aca.location

 body = jsonencode({
 properties = {
 managedEnvironmentId = azapi_resource.env.id
 configuration = {
 ingress = {
 allowInsecure = false
 external = true
 targetPort = 80
 traffic = [
 {
 label = "dev"
 latestRevision = true
 weight = 100
 }
 ]
 }
 }
 template = {
 containers = [
 {
 name = "helloworld"
 image = "mcr.microsoft.com/azuredocs/containerapps-helloworld:latest"
 resources = {
 cpu = 0.5
 memory = "1.0Gi"
 }
 }
 ]
 revisionSuffix = random_string.aca.result
 scale = {
 minReplicas = 0
 maxReplicas = 30
 rules = [
 {
 name = "http-rule"
 http = {
 metadata = {
 concurrentRequests = "100"
 }
 }
 }
 ]
 }
 }
 }
 })

 # this tells azapi to pull out properties and stuff into the output attribute for the object
 response_export_values = ["properties.configuration.ingress.fqdn"]
}

data "azurerm_subscription" "aca" {}
data "azurerm_client_config" "aca" {}

resource "azapi_resource" "amg" {
 type = "Microsoft.Dashboard/grafana@2022-08-01"
 name = "amg-${local.resource_name}"
 parent_id = azurerm_resource_group.aca.id
 location = azurerm_resource_group.aca.location

 identity {
 type = "SystemAssigned"
 }

 body = jsonencode({
 properties = {
 apiKey = "Enabled"
 autoGeneratedDomainNameLabelScope = "TenantReuse"
 deterministicOutboundIP = "Enabled"
 publicNetworkAccess = "Enabled"
 zoneRedundancy = "Disabled"
 }
 sku = {
 name = "Standard"
 }
 })

 # this tells azapi to pull out properties and stuff into the output attribute for the object
 response_export_values = ["identity.principalId"]
}

resource "azurerm_role_assignment" "amg_reader" {
 scope = data.azurerm_subscription.aca.id
 role_definition_name = "Monitoring Reader"
 principal_id = jsondecode(azapi_resource.amg.output).identity.principalId
}

resource "azurerm_role_assignment" "amg_admin" {
 scope = azapi_resource.amg.id
 role_definition_name = "Grafana Admin"
 principal_id = data.azurerm_client_config.aca.object_id
}

output "helloworld_ingress_url" {
 value = format("%s%s", "https://", jsondecode(azapi_resource.helloworld.output).properties.configuration.ingress.fqdn)
}

# optional to automate the dashboard import process
resource "null_resource" "aca" {
 provisioner "local-exec" {
 command = <<-EOT
 az config set extension.use_dynamic_install=yes_without_prompt
 az grafana dashboard import -g ${azurerm_resource_group.aca.name} -n ${azapi_resource.amg.name} --definition 16592
 EOT
 }
}