ContextQMD
Back to Directus

Deployments

content/guides/12.integrations/5.netlify/deployments.md

latest3.0 KB
Original Source

After linking your Netlify account and configuring your sites, manage all deployment activities directly from Directus.

Trigger deployments after publishing content updates that impact your frontend.

← Back to Netlify Integration

Triggering Deployments

Start a new deployment for any connected Netlify site:

  1. Navigate to the Deployment module
  2. Click on the Netlify provider
  3. Select the site you want to deploy
  4. Click the Deploy button in the top right
  5. Netlify will begin building and deploying your site

Each deployment is logged in Directus with its deployment metadata.

Monitoring Deployment Status

Track your deployments in the deployment list view. The list displays:

  • Deploy ID: Netlify identifier for each build
  • Status: Current deployment state
    • BUILDING: Build is in progress
    • READY: Site is successfully built, deployed, and live
    • CANCELED: Deployment was stopped before completion
    • ERROR: Build or deploy phase failed
  • Context: Deployment environment (production, branch deploy, etc.)
  • Started: When the build began
  • Duration: Build time
  • Author: Who initiated the deployment

Viewing Build Logs

Access detailed build logs for any deployment:

  1. Click any deployment from the site list
  2. View the full build output, including:
    • Build steps and timing
    • Plugin execution details
    • Asset optimization and caching
    • Error messages (if applicable)
  3. Use search to locate specific log entries
  4. Filter by log level (All, Stdout, Stderr) to narrow results

Build logs are essential for diagnosing deployment issues and understanding your build pipeline.

Exporting Logs

Download deployment logs for records or debugging:

  1. Open the deployment details view
  2. Click the Download icon in the top right
  3. Logs are saved as a text file with timestamps

Visiting Deployed Sites

Access your live deployments quickly:

  1. From the deployment details view, click the Visit button
  2. Your deployed site opens in a new tab

Best Practices

Deployment Workflow

  • Deploy after publishing content changes that affect your frontend
  • Monitor initial deployments after setup to confirm builds succeed
  • Retain build logs for failed deployments to aid troubleshooting

Performance Tips

  • Build durations in the deployment list help track performance trends
  • Netlify's build cache can accelerate subsequent builds

Troubleshooting

  • For failed deployments, review build logs for error details
  • Confirm your Netlify site configuration and build settings
  • Verify your Personal Access Token has required permissions

Next Steps