Skip to content

Rr 115 update docs#138

Draft
ryanraaschCDC wants to merge 7 commits intomainfrom
rr-115-update-docs
Draft

Rr 115 update docs#138
ryanraaschCDC wants to merge 7 commits intomainfrom
rr-115-update-docs

Conversation

@ryanraaschCDC
Copy link
Copy Markdown
Collaborator

No description provided.

@ryanraaschCDC ryanraaschCDC requested a review from Copilot March 19, 2026 13:11
@ryanraaschCDC ryanraaschCDC linked an issue Mar 19, 2026 that may be closed by this pull request
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the documentation to improve onboarding/troubleshooting guidance and reflect newer client capabilities in cfa-cloudops.

Changes:

  • Add new troubleshooting sections for CloudClient instantiation and file-path/mount issues during jobs
  • Expand the CloudClient getting-started notebook with clearer guidance around env files, blob containers, ACR uploads, pools, and jobs
  • Update docs to mention ContainerAppClient and adjust the service-principal sample .env

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 8 comments.

Show a summary per file
File Description
docs/troubleshooting.md Adds new troubleshooting guidance for CloudClient instantiation and file-not-found issues.
docs/overview.md Mentions ContainerAppClient as a repo component.
docs/files/sp_sample.env Removes AZURE_SP_CLIENT_ID from the SP sample env.
docs/examples/getting_started/cloudclient_walkthrough.ipynb Expands the getting-started walkthrough with additional explanations and examples.
docs/examples/getting_started/Dockerfile Replaces the minimal Dockerfile with a more explanatory example.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@@ -2,7 +2,6 @@
AZURE_TENANT_ID="your azure tenant id"
AZURE_SUBSCRIPTION_ID="your subscription id"
AZURE_CLIENT_ID="your azure service principal client id"
"metadata": {},
"source": [
"The initialization below is the simplest way to create and instance of the `CloudClient` class. If a variable called AZURE_KEYVAULT_NAME is saved to your environment, the `CloudClient` will initialize based on some Azure values stored in the Key Vault. Otherwise it will use environment variables or values stored in a .env file to authenticate, like the .env file stored [here](../../files/sample.env), and a managed identity credential based on your local working environment. The .env file should be stored at the same level in the directory in which you're working."
"The initialization below is the simplest way to create and instance of the `CloudClient` class. If a variable called AZURE_KEYVAULT_NAME is saved to your environment, the `CloudClient` will initialize based on some Azure values stored in the Key Vault. Otherwise it will use environment variables or values stored in a .env file to authenticate, like the .env file stored [here](../../files/sample.env), and a managed identity credential based on your local working environment. The .env file should be stored at the same level in the directory in which you're working. **Make sure to update your .env file based on the sample with values relevant to your Azure environment.**"
ryanraaschCDC and others added 5 commits March 19, 2026 06:30
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@ryanraaschCDC ryanraaschCDC requested a review from sfrosenb March 19, 2026 13:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

provide Docker help

3 participants