|
| 1 | +# Next Steps after `azd init` |
| 2 | + |
| 3 | +## Table of Contents |
| 4 | + |
| 5 | +1. [Next Steps](#next-steps) |
| 6 | +2. [What was added](#what-was-added) |
| 7 | +3. [Billing](#billing) |
| 8 | +4. [Troubleshooting](#troubleshooting) |
| 9 | + |
| 10 | +## Next Steps |
| 11 | + |
| 12 | +### Provision infrastructure and deploy application code |
| 13 | + |
| 14 | +Run `azd up` to provision your infrastructure and deploy to Azure in one step (or run `azd provision` then `azd deploy` to accomplish the tasks separately). Visit the service endpoints listed to see your application up-and-running! |
| 15 | + |
| 16 | +To troubleshoot any issues, see [troubleshooting](#troubleshooting). |
| 17 | + |
| 18 | +### Configure CI/CD pipeline |
| 19 | + |
| 20 | +Run `azd pipeline config -e <environment name>` to configure the deployment pipeline to connect securely to Azure. An environment name is specified here to configure the pipeline with a different environment for isolation purposes. Run `azd env list` and `azd env set` to reselect the default environment after this step. |
| 21 | + |
| 22 | +- Deploying with `GitHub Actions`: Select `GitHub` when prompted for a provider. If your project lacks the `azure-dev.yml` file, accept the prompt to add it and proceed with pipeline configuration. |
| 23 | + |
| 24 | +- Deploying with `Azure DevOps Pipeline`: Select `Azure DevOps` when prompted for a provider. If your project lacks the `azure-dev.yml` file, accept the prompt to add it and proceed with pipeline configuration. |
| 25 | + |
| 26 | +## What was added |
| 27 | + |
| 28 | +### Infrastructure configuration |
| 29 | + |
| 30 | +To describe the infrastructure and application, an `azure.yaml` was added with the following directory structure: |
| 31 | + |
| 32 | +```yaml |
| 33 | +- azure.yaml # azd project configuration |
| 34 | +``` |
| 35 | +
|
| 36 | +This file contains a single service, which references your project's App Host. When needed, `azd` generates the required infrastructure as code in memory and uses it. |
| 37 | + |
| 38 | +If you would like to see or modify the infrastructure that `azd` uses, run `azd infra gen` to generate it to disk. |
| 39 | + |
| 40 | +If you do this, some additional directories will be created: |
| 41 | + |
| 42 | +```yaml |
| 43 | +- infra/ # Infrastructure as Code (bicep) files |
| 44 | + - main.bicep # main deployment module |
| 45 | + - resources.bicep # resources shared across your application's services |
| 46 | +``` |
| 47 | + |
| 48 | +In addition, for each project resource referenced by your app host, a `containerApp.tmpl.yaml` file will be created in a directory named `manifests` next the project file. This file contains the infrastructure as code for running the project on Azure Container Apps. |
| 49 | + |
| 50 | +*Note*: Once you have generated your infrastructure to disk, those files are the source of truth for azd. Any changes made to `azure.yaml` or your App Host will not be reflected in the infrastructure until you regenerate it with `azd infra gen` again. It will prompt you before overwriting files. You can pass `--force` to force `azd infra gen` to overwrite the files without prompting. |
| 51 | + |
| 52 | +## Billing |
| 53 | + |
| 54 | +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](https://learn.microsoft.com/azure/developer/intro/azure-developer-billing). |
| 55 | + |
| 56 | +## Troubleshooting |
| 57 | + |
| 58 | +Q: I visited the service endpoint listed, and I'm seeing a blank page, a generic welcome page, or an error page. |
| 59 | + |
| 60 | +A: Your service may have failed to start, or it may be missing some configuration settings. To investigate further: |
| 61 | + |
| 62 | +1. Run `azd show`. Click on the link under "View in Azure Portal" to open the resource group in Azure Portal. |
| 63 | +2. Navigate to the specific Container App service that is failing to deploy. |
| 64 | +3. Click on the failing revision under "Revisions with Issues". |
| 65 | +4. Review "Status details" for more information about the type of failure. |
| 66 | +5. Observe the log outputs from Console log stream and System log stream to identify any errors. |
| 67 | +6. If logs are written to disk, use *Console* in the navigation to connect to a shell within the running container. |
| 68 | + |
| 69 | +For more troubleshooting information, visit [Container Apps troubleshooting](https://learn.microsoft.com/azure/container-apps/troubleshooting). |
| 70 | + |
| 71 | +### Additional information |
| 72 | + |
| 73 | +For additional information about setting up your `azd` project, visit our official [docs](https://learn.microsoft.com/azure/developer/azure-developer-cli/make-azd-compatible?pivots=azd-convert). |
0 commit comments