Azure / Azure/azure-cli

Customer feedback | az containerapp job (both Core and Extension) | Warning about behavior of job start #

Open
#29,356 2 comments 0 reactions 0 assignees View on GitHub
act-observability-squad Auto-Assign bug ContainerApp Service Attention
Dominant language
Python
Stars
4.6k
Forks
3.5k
Avg merge
3d 2h
Merged PRs (30d)
60

Description

### Describe the bug

This GitHub issue is being moved from MicrosoftDocs/azure-docs-cli [GitHub issue #4456](https://github.com/MicrosoftDocs/azure-docs-cli/issues/4456).

*******************************
**Type of issue**
Missing information

**Feedback**
The documentation should be enhanced by including a cautionary note regarding the start of a new job and overridden configuration. In particular, based on my examinations:

Emphasize that options such as --command, --args, --env-vars, etc., are functional only when used in conjunction with --image
Referring to the [documentation](https://learn.microsoft.com/en-us/azure/container-apps/jobs?tabs=azure-cli#start-a-job-execution-on-demand), note that "When overriding the configuration, the job's entire template configuration is replaced with the new configuration. Ensure that the new configuration includes all required settings.". Therefore, the statement "Empty string to clear existing values" on certain parameters may be misleading, as in my assessments, the environment variables specified by the container are cleared even in the absence of the --env-vars parameter.

**Page URL**
https://learn.microsoft.com/en-us/cli/azure/containerapp/job?view=azure-cli-latest

**Content source URL**
https://github.com/MicrosoftDocs/azure-docs-cli/blob/main/latest/docs-ref-autogen/containerapp/job.yml
********************************************

### Related command

az containerapp job

### Errors

n/a

### Issue script & Debug output

n/a

### Expected behavior

n/a

### Environment Summary

n/a

### Additional context

n/a

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.