You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/dev-box/how-to-write-customization-file.md
+1-37Lines changed: 1 addition & 37 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -90,44 +90,8 @@ You can create and manage customization files with Visual Studio Code. You can u
90
90
91
91
1. When the customization file runs successfully, upload it to your catalog.
92
92
93
-
## Use GitHub Copilot to write a customization file
94
-
The Microsoft Dev Box extension for Visual Studio Code integrates with GitHub Copilot Chat to bring the power of AI to creating your customization file. You can use GitHub Copilot to help write a customization file for your development team.
95
-
96
-
There are two commands that you can use with the Dev Box chat agent:
97
-
- Tasks: Lists available tasks for this dev box, and answers task related questions.
98
-
- Customize: Generates custom tasks based on your commands and available tasks.
99
-
100
-
To use GitHub Copilot, you need to install the GitHub Copilot extension in Visual Studio Code. For more information, see [GitHub Copilot](https://code.visualstudio.com/docs/copilot/overview).
101
-
102
-
To invoke the Dev Box chat agent:
103
-
1. In Visual Studio Code, open a customization file.
104
-
1. From the Activity Bar, select Chat.
105
-
1. In the chat box, enter **@devbox**.
106
-
107
-
:::image type="content" source="media/how-to-write-customization-file/github-copilot-chat-dev-box-commands.png" alt-text="Screenshot of GitHub Copilot Chat in Visual Studio Code, showing the 'devbox' command and two available commands: 'Tasks'and 'Customize'.":::
108
-
109
-
1. To list available tasks for this dev box, enter **@devbox /tasks list-tasks** in the chat box.
110
-
111
-
You see the list of available tasks in the chat box. These tasks are available in the catalog attached to the dev center, or in the catalog attached to your project.
112
-
113
-
:::image type="content" source="media/how-to-write-customization-file/github-copilot-chat-dev-box-tasks-available.png" alt-text="Screenshot showing available tasks for the dev box in GitHub Copilot Chat.":::
114
-
115
-
1. To ask a task based question, enter your question in Copilot Chat. Try it: enter **@devbox /tasks Are there any tasks to clone a repo?** in the chat box.
116
-
117
-
:::image type="content" source="media/how-to-write-customization-file/github-copilot-chat-dev-box-task-question.png" alt-text="Screenshot showing a task based question in GitHub Copilot Chat.":::
118
-
119
-
This example clones the microsoft/calculator repository to the C:\Workspaces directory.
120
-
121
-
1. To generate a custom task, enter **@devbox /customize** and a description of the task you want to create. Try it: enter **@devbox /customize I want to install notepad++ and vscode** in the chat box.
122
-
123
-
:::image type="content" source="media/how-to-write-customization-file/github-copilot-chat-dev-box-customize.png" alt-text="Screenshot showing a custom task generated in GitHub Copilot Chat.":::
124
-
125
-
This example installs Notepad++ and Visual Studio Code on the dev box.
126
-
127
-
You can select **Generate Workload.yaml File** to create a file with the custom task. You can then rename the *workload.yaml* file to *imagedefintion.yaml*for use in your team customizations.
128
-
129
93
## Clone a private repository using a customization file
130
-
You can use secrets from your Azure Key Vault in your yaml customizations to clone private repositories, or with any custom task you author that requires an access token. In a team customization file, you can use a personal access token (PAT) sotred in a key vault to access a private repository. In an individual customization file, you can also use the `{{ado}}` or `{{ado://your-ado-organization-name}}` parameter to fetch an access token on your behalf when creating a dev box.
94
+
You can use secrets from your Azure Key Vault in your yaml customizations to clone private repositories, or with any custom task you author that requires an access token. In a team customization file, you can use a personal access token (PAT) stored in a key vault to access a private repository. git
131
95
132
96
### Use Key Vault secrets in team customization files
133
97
To clone a private repository, store your PAT as an Azure KeyVault secret, and use it when invoking the git-clone task in your customization.
The image definition file specifies a name for the image definition by using a `name` field. Use this name to identify the image definition in the dev box pool.
32
+
Note that the image definition file specifies a name for the image definition by using a `name` field. Use this name to identify the image definition in the dev box pool.
0 commit comments