Natuurlijk! Hieronder vind je een overzicht van best practices, een stapsgewijze outline en voorbeeldconfiguraties voor het opzetten van een CI/CD-pijplijn met Pulumi voor je Node.js applicatie op AWS. **Best Practices** 1. **Versiebeheer en Branching** Gebruik Git voor versiebeheer. Werk met feature-branches en een duidelijke branching-strategie (bijvoorbeeld GitFlow). 2. **Automatiseer Tests** Voer unit-, integratie- en end-to-end tests uit vóór deployment. Gebruik CI-tools zoals GitHub Actions, GitLab CI, Jenkins of andere. 3. **Pulumi State Management** Gebruik een remote backend (bijvoorbeeld Pulumi Service, AWS S3 + DynamoDB voor state locking) voor gedeelde en veilige opslag van je infrastructuurstatus. 4. **Geautomatiseerde Deployment & Rollback** Implementeer automatische deployment bij succesvolle tests. Gebruik Pulumi’s stack-rollback functionaliteit bij fouten. 5. **Security & Secrets** Behandel secrets veilig via CI/CD-omgeving variabelen of secret management tools (bijvoorbeeld AWS Secrets Manager, Pulumi Secrets). 6. **Monitoring & Logging** Monitor je applicatie en infrastructuur na deployment. Gebruik CloudWatch, Pulumi’s audit logs, en alerting. --- **Stapsgewijze Outline van de CI/CD-Pijplijn** 1. **Code Commit & Branching** Developer commit code op feature-branch. 2. **Automatische Build & Tests** - Installeer dependencies (`npm install`). - Voer unit- en integratietests uit (`npm test`). - Bij success, ga verder; bij failure, stop en rapporteer. 3. **Pulumi Preview** - Voer `pulumi preview` om infrastructuurwijzigingen te bekijken. - Controleer of de wijzigingen correct zijn. 4. **Pulumi Deploy** - Voer `pulumi up --yes` uit om de infrastructuur bij te werken. - Bij fouten, rol automatisch terug. 5. **Applicatie Deployment** - Bouw je Node.js applicatie (`npm run build` indien nodig). - Deploy de applicatie naar AWS (bijvoorbeeld via Elastic Beanstalk, ECS, Lambda of S3). 6. **Validatie & Tests** - Voer integration/end-to-end testen op de live omgeving uit. 7. **Monitoring & Alerting** - Controleer de status en logs. - Bij problemen, voer een rollback uit. --- **Voorbeeldconfiguratie (GitHub Actions)** ```yaml name: CI/CD Pulumi AWS Deployment on: push: branches: - main - feature/* jobs: build-and-deploy: runs-on: ubuntu-latest env: AWS_REGION: 'eu-west-1' PULUMI_ACCESS_TOKEN: ${{ secrets.PULUMI_ACCESS_TOKEN }} steps: - name: Checkout code uses: actions/checkout@v3 - name: Set up Node.js uses: actions/setup-node@v3 with: node-version: '14' - name: Install dependencies run: npm install - name: Run tests run: npm test - name: Install Pulumi run: curl -fsSL https://get.pulumi.com | sh - name: Pulumi preview run: | npm install pulumi login pulumi stack select <jouw-stack> # e.g., dev of productie pulumi preview --yes --diff - name: Pulumi deployment run: | pulumi up --yes --skip-preview - name: Deploy applicatie run: | # Voeg hier je deployment script toe, bv. via AWS CLI of SDK aws s3 sync ./build s3://jouw-bucket --delete - name: Post-deployment tests run: | # Voer validaties uit, bv. API tests ``` **Aanvullende Tips:** - Gebruik Pulumi stacks voor verschillende omgevingen (dev, staging, productie). - Automatiseer rollback door Pulumi’s ingebouwde functionaliteit te gebruiken. - Implementeer notificaties (bijv. Slack, email) bij success/failure. - Documenteer je infrastructuur en deploymentproces. --- Heeft je nog specifieke vragen of wil je hulp bij het aanpassen van deze configuraties?

Zeker! Hier is een complete gids voor het opzetten van een CI/CD-pijplijn met Pulumi voor je Node.js applicatie op AWS. ## Best Practices voor Pulumi CI/CD 1. **Infrastructure as Code (IaC)** - Houd infrastructuurcode gescheiden van applicatiecode - Gebruik TypeScript voor betere type safety - Implementeer stack references voor gedeelde resources 2. **Beveiliging** - Gebruik AWS Secrets Manager voor gevoelige data - Implementeer minimale rechten (principle of least privilege) - Gebruik Pulumi Cloud voor state management 3. **Omgevingsbeheer** - Aparte stacks voor dev, staging, production - Gebruik stack configuratie voor omgevingsspecifieke waarden ## Stapsgewijze Implementatie ### Stap 1: Projectstructuur ``` my-app/ ├── infrastructure/ │ ├── Pulumi.yaml │ ├── Pulumi.dev.yaml │ ├── Pulumi.prod.yaml │ └── index.ts ├── src/ │ └── (je Node.js applicatie) └── .github/ └── workflows/ └── ci-cd.yml ``` ### Stap 2: Pulumi Configuratie **infrastructure/Pulumi.yaml** ```yaml name: my-app-infra runtime: nodejs description: Infrastructure for my Node.js application ``` **infrastructure/Pulumi.dev.yaml** ```yaml config: aws:region: eu-west-1 my-app-infra:environment: dev my-app-infra:domain: dev.myapp.com my-app-infra:nodeVersion: 18 ``` **infrastructure/index.ts** ```typescript import * as pulumi from "@pulumi/pulumi"; import * as aws from "@pulumi/aws"; import * as awsx from "@pulumi/awsx"; const config = new pulumi.Config(); const environment = config.require("environment"); // VPC voor de applicatie const vpc = new awsx.ec2.Vpc("my-app-vpc", { numberOfAvailabilityZones: 2, }); // ECR Repository voor Docker images const repo = new awsx.ecr.Repository("my-app-repo", { forceDelete: true, }); // ECS Cluster const cluster = new aws.ecs.Cluster("my-app-cluster", {}); // Load Balancer const alb = new awsx.lb.ApplicationLoadBalancer("my-app-alb", { vpc, external: true, listener: { port: 80, }, }); // ECS Task Definition const taskDefinition = new awsx.ecs.FargateTaskDefinition("my-app-task", { container: { image: repo.repository.url.apply(url => `${url}:latest`), cpu: 256, memory: 512, portMappings: [{ containerPort: 3000, targetGroup: alb.defaultTargetGroup, }], environment: [ { name: "NODE_ENV", value: environment }, ], }, }); // ECS Service const service = new awsx.ecs.FargateService("my-app-service", { cluster: cluster.arn, taskDefinition: taskDefinition.taskDefinition.arn, desiredCount: 1, networkConfiguration: { subnets: vpc.privateSubnetIds, securityGroups: vpc.defaultSecurityGroupIds, assignPublicIp: false, }, }); // Export belangrijke waarden export const url = alb.loadBalancer.dnsName; export const repositoryUrl = repo.repository.url; ``` ### Stap 3: GitHub Actions Workflow **.github/workflows/ci-cd.yml** ```yaml name: CI/CD Pipeline on: push: branches: [ main, develop ] pull_request: branches: [ main ] env: AWS_REGION: eu-west-1 PULUMI_VERSION: 3.0.0 jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: Setup Node.js uses: actions/setup-node@v3 with: node-version: '18' cache: 'npm' - name: Install dependencies run: npm ci - name: Run tests run: npm test - name: Run linting run: npm run lint deploy-dev: needs: test if: github.ref == 'refs/heads/develop' runs-on: ubuntu-latest environment: dev steps: - uses: actions/checkout@v3 - name: Configure AWS credentials uses: aws-actions/configure-aws-credentials@v2 with: aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }} aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }} aws-region: ${{ env.AWS_REGION }} - name: Setup Pulumi uses: pulumi/setup-pulumi@v3 with: pulumi-version: ${{ env.PULUMI_VERSION }} - name: Build Docker image run: | docker build -t my-app:latest . - name: Configure AWS CLI for ECR run: | aws ecr get-login-password --region $AWS_REGION | docker login --username AWS --password-stdin ${{ secrets.AWS_ACCOUNT_ID }}.dkr.ecr.$AWS_REGION.amazonaws.com - name: Deploy to ECR run: | docker tag my-app:latest ${{ secrets.AWS_ACCOUNT_ID }}.dkr.ecr.$AWS_REGION.amazonaws.com/my-app-repo:latest docker push ${{ secrets.AWS_ACCOUNT_ID }}.dkr.ecr.$AWS_REGION.amazonaws.com/my-app-repo:latest - name: Deploy Infrastructure working-directory: ./infrastructure run: | pulumi stack select dev pulumi config set aws:region ${{ env.AWS_REGION }} pulumi up --yes deploy-prod: needs: test if: github.ref == 'refs/heads/main' runs-on: ubuntu-latest environment: production steps: - uses: actions/checkout@v3 - name: Configure AWS credentials uses: aws-actions/configure-aws-credentials@v2 with: aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }} aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }} aws-region: ${{ env.AWS_REGION }} - name: Setup Pulumi uses: pulumi/setup-pulumi@v3 - name: Build and push Docker image run: | docker build -t my-app:${{ github.sha }} . aws ecr get-login-password --region $AWS_REGION | docker login --username AWS --password-stdin ${{ secrets.AWS_ACCOUNT_ID }}.dkr.ecr.$AWS_REGION.amazonaws.com docker tag my-app:${{ github.sha }} ${{ secrets.AWS_ACCOUNT_ID }}.dkr.ecr.$AWS_REGION.amazonaws.com/my-app-repo:${{ github.sha }} docker push ${{ secrets.AWS_ACCOUNT_ID }}.dkr.ecr.$AWS_REGION.amazonaws.com/my-app-repo:${{ github.sha }} - name: Deploy to Production working-directory: ./infrastructure run: | pulumi stack select production pulumi config set containerImageTag ${{ github.sha }} pulumi up --yes rollback: needs: deploy-prod if: failure() runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: Configure AWS credentials uses: aws-actions/configure-aws-credentials@v2 with: aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }} aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }} aws-region: ${{ env.AWS_REGION }} - name: Setup Pulumi uses: pulumi/setup-pulumi@v3 - name: Rollback to previous version working-directory: ./infrastructure run: | pulumi stack select production pulumi stack export | jq '.deployment.secrets' > secrets.json pulumi stack import --file <(pulumi stack export | jq '.deployment.prev=null') pulumi up --yes ``` ### Stap 4: Dockerfile voor Node.js Applicatie ```dockerfile FROM node:18-alpine WORKDIR /app COPY package*.json ./ RUN npm ci --only=production COPY . . EXPOSE 3000 USER node CMD ["node", "src/index.js"] ``` ### Stap 5: Rollback Strategie **Handmatige Rollback Script:** ```typescript // infrastructure/rollback.ts import * as pulumi from "@pulumi/pulumi"; async function rollback() { const stack = await pulumi.automation.LocalWorkspace.selectStack({ stackName: "production", projectName: "my-app-infra", }); // Terug naar vorige succesvolle deployment const history = await stack.history(); const lastSuccessful = history.find(deploy => deploy.result === "succeeded"); if (lastSuccessful) { await stack.importStack(lastSuccessful.version); console.log("Rollback voltooid"); } } rollback(); ``` ## Aanbevolen GitHub Secrets - `AWS_ACCESS_KEY_ID` - `AWS_SECRET_ACCESS_KEY` - `AWS_ACCOUNT_ID` - `PULUMI_ACCESS_TOKEN` (voor Pulumi Cloud) ## Monitoring en Notificaties Voeg deze stappen toe aan je workflow voor monitoring: ```yaml - name: Notify Slack on Failure if: failure() uses: 8398a7/action-slack@v3 with: status: failure channel: '#deployments' ``` Deze pijplijn biedt: - ✅ Geautomatiseerde testing - ✅ Multi-omgeving deployments - ✅ Rollback mogelijkheden - ✅ Beveiligde configuratie - ✅ Infrastructure as Code met Pulumi Succes met de implementatie!