Skip to content

next-steps.md

Latest commit

 

History

History
95 lines (61 loc) · 4.66 KB

next-steps.md

File metadata and controls

95 lines (61 loc) · 4.66 KB
Raw

Next Steps after azd init

Table of Contents

  1. Next Steps
  2. What was added
  3. Billing
  4. Troubleshooting

Next Steps

Provision infrastructure and deploy application code

Run azd up to provision your infrastructure and deploy to Azure (or run azd provision then azd deploy to accomplish the tasks separately). Visit the service endpoints listed to see your application up-and-running!

To troubleshoot any issues, see troubleshooting.

Configure environment variables for running services

Configure environment variables for running services by updating settings in main.parameters.json.

Configure CI/CD pipeline

  1. Create a workflow pipeline file locally. The following starters are available:
  2. Run azd pipeline config to configure the deployment pipeline to connect securely to Azure.

What was added

Infrastructure configuration

To describe the infrastructure and application, azure.yaml along with Infrastructure as Code files using Bicep were added with the following directory structure:

- azure.yaml        # azd project configuration
- infra/            # Infrastructure-as-code Bicep files
  - main.bicep      # Main deployment template
  - modules/        # Library modules

The resources declared in main.bicep are provisioned when running azd up or azd provision. This includes:

  • AI Foundry (AI Services and AI Project)
  • AI Search
  • Storage Account
  • Cosmos DB
  • SQL Database
  • App Service Plan and Web Apps (backend API and frontend)
  • Virtual Network and Private Endpoints (WAF deployment)

More information about Bicep language.

Build from source (no Dockerfile)

Build with Buildpacks using Oryx

If your project does not contain a Dockerfile, we will use Buildpacks using Oryx to create an image for the services in azure.yaml and get your containerized app onto Azure.

To produce and run the docker image locally:

  1. Run azd package to build the image.
  2. Copy the Image Tag shown.
  3. Run docker run -it <Image Tag> to run the image locally.

Exposed port

Oryx will automatically set PORT to a default value of 80 (port 8080 for Java). Additionally, it will auto-configure supported web servers such as gunicorn and ASP .NET Core to listen to the target PORT. If your application already listens to the port specified by the PORT variable, the application will work out-of-the-box. Otherwise, you may need to perform one of the steps below:

  1. Update your application code or configuration to listen to the port specified by the PORT variable
  2. (Alternatively) Search for targetPort in a .bicep file under the infra/app folder, and update the variable to match the port used by the application.

Billing

Visit the Cost Management + Billing page in Azure Portal to track current spend. For more information about how you're billed, and how you can monitor the costs incurred in your Azure subscriptions, visit billing overview.

Troubleshooting

Q: I visited the service endpoint listed, and I'm seeing a blank page, a generic welcome page, or an error page.

A: Your service may have failed to start, or it may be missing some configuration settings. To investigate further:

  1. Run azd show. Click on the link under "View in Azure Portal" to open the resource group in Azure Portal.
  2. Navigate to the specific App Service that is failing to deploy.
  3. Check the Deployment Center logs for deployment errors.
  4. Review Log stream for application runtime errors.
  5. Check Diagnose and solve problems for platform-level issues.
  6. If you need access to the running container, use the App Service SSH/Console experience in Azure Portal or run az webapp ssh. Use Advanced Tools (Kudu) to inspect the SCM site, filesystem, and any logs written to disk.

For more troubleshooting information, visit App Service troubleshooting.

Additional information

For additional information about setting up your azd project, visit our official docs.