Skip to content

lesson-07-containers.md

Latest commit

 

History

History
283 lines (211 loc) · 5.67 KB

lesson-07-containers.md

File metadata and controls

283 lines (211 loc) · 5.67 KB

Lesson 07: Container Services - Copy-Paste Commands

📋 Setup Variables

Copy and paste this block first to set up your variables:

# Configuration
LOCATION="centralus"
RESOURCE_GROUP="rg-essentials-containers"
UNIQUE_SUFFIX=$(openssl rand -hex 4)
ACR_NAME="acressentials${UNIQUE_SUFFIX}"

# Display the ACR name (save this!)
echo "Container Registry: $ACR_NAME"

Step 1: Create Resource Group

# Create the resource group
az group create \
    --name "$RESOURCE_GROUP" \
    --location "$LOCATION" \
    --tags "course=azure-essentials" "lesson=07-containers"

Step 2: Create Azure Container Registry

# Create Container Registry (Basic SKU)
az acr create \
    --name "$ACR_NAME" \
    --resource-group "$RESOURCE_GROUP" \
    --location "$LOCATION" \
    --sku Basic \
    --admin-enabled true

Step 3: Get ACR Credentials

# Get the login server URL
az acr show \
    --name "$ACR_NAME" \
    --resource-group "$RESOURCE_GROUP" \
    --query loginServer \
    -o tsv
# Get admin credentials
az acr credential show \
    --name "$ACR_NAME" \
    --resource-group "$RESOURCE_GROUP" \
    --query "{Username:username, Password:passwords[0].value}" \
    -o table

Step 4: Login to ACR

# Login to the container registry
az acr login --name "$ACR_NAME"

Step 5: Build Hello Container in ACR

💡 No Docker Required! ACR Tasks builds the image in Azure.

The sample app is in lessons/07-container-services/src/hello-container/:

# Navigate to repo root (adjust path as needed)
cd /path/to/azure_essentials

# Build hello-container directly in ACR
az acr build \
    --registry "$ACR_NAME" \
    --image "hello-container:v1" \
    --file "lessons/07-container-services/src/hello-container/Dockerfile" \
    "lessons/07-container-services/src/hello-container"

Alternative: Create a simple sample inline:

# Create a simple Dockerfile
cat << 'EOF' > /tmp/Dockerfile
FROM python:3.13-alpine
WORKDIR /app
RUN pip install flask gunicorn
COPY <<PYEOF app.py
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
    return "<h1>Hello from Azure!</h1>"

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=8080)
PYEOF
EXPOSE 8080
CMD ["gunicorn", "-b", "0.0.0.0:8080", "app:app"]
EOF

# Build it in ACR
az acr build --registry "$ACR_NAME" --image "hello-container:v1" /tmp

Step 6: List Images in Registry

# List repositories
az acr repository list \
    --name "$ACR_NAME" \
    -o table
# Show image tags
az acr repository show-tags \
    --name "$ACR_NAME" \
    --repository "hello-container" \
    -o table

Step 7: View Image Details

# Show image manifest
az acr repository show \
    --name "$ACR_NAME" \
    --image "hello-container:v1"

Part 2: Run Container (Optional - Requires Docker)

ℹ️ This section requires Docker installed locally. Skip if using Cloud Shell.

Pull and Run the Image Locally

# Get the login server
LOGIN_SERVER=$(az acr show --name "$ACR_NAME" --query loginServer -o tsv)

# Login to ACR
az acr login --name "$ACR_NAME"

# Pull the image
docker pull ${LOGIN_SERVER}/hello-container:v1

# Run the container
docker run -d -p 8080:8080 ${LOGIN_SERVER}/hello-container:v1

# Visit http://localhost:8080

📊 View ACR Information

# Show ACR details
az acr show \
    --name "$ACR_NAME" \
    --resource-group "$RESOURCE_GROUP" \
    --query "{Name:name, LoginServer:loginServer, SKU:sku.name, AdminEnabled:adminUserEnabled}" \
    -o table
# Check ACR usage
az acr show-usage \
    --name "$ACR_NAME" \
    -o table

📚 Additional Commands

Tag and Push an Image (Alternative Method)

If you built an image locally with Docker:

# Tag the image
docker tag myimage:latest ${LOGIN_SERVER}/myimage:v1

# Push to ACR
docker push ${LOGIN_SERVER}/myimage:v1

Delete an Image

# Delete a specific tag
az acr repository delete \
    --name "$ACR_NAME" \
    --image "hello-container:v1" \
    --yes

Enable Content Trust

# Enable content trust (Premium SKU only)
# az acr config content-trust update --name "$ACR_NAME" --status enabled

View Build Logs

# List recent build tasks
az acr task list-runs \
    --registry "$ACR_NAME" \
    -o table

🧹 Cleanup

# Delete the entire resource group
az group delete \
    --name "$RESOURCE_GROUP" \
    --yes \
    --no-wait

echo "Cleanup initiated - resources deleting in background"
# Clean up temp files
rm -f /tmp/Dockerfile /tmp/index.html

🔗 Quick Reference

Command Description
az acr create Create container registry
az acr login Login to registry
az acr build Build image in ACR (no Docker needed)
az acr repository list List all repositories
az acr repository show-tags List image tags
az acr credential show Get admin credentials
az acr show-usage View storage usage

🏗️ ACR SKU Comparison

Feature Basic Standard Premium
Storage 10 GB 100 GB 500 GB
Webhooks 2 10 500
Geo-replication ❌ ❌ ✅
Content Trust ❌ ❌ ✅
Private Link ❌ ❌ ✅