bicep
bicep copied to clipboard
We should be finding some resources by common terms/aliases (e.g. find serverfarms by typing in appserviceplan)
There are two ways that we want to provide suggestions in order to achieve #6249. Ultimately this would include adding tags such as "k8s", "kubernetes", or "cluster" to the description metadata of specific resources and snippets. The first would be considered snippet suggestions
- "res-aks-cluster"
The second would be resource suggestions
Again we would accomplish improving the searchability through tags.
Do you have any examples of resources or snippets that are named confusingly? What tags/searchable terms would you expect for res-ask-cluster? What tags would you expect for Microsoft.Web/sites@2018-11-01
?
RBAC
resource rbac 'Microsoft.Authorization/roleAssignments@2021-04-01-preview' = {
name: guid(storageAccount.id, principalId, roleDefinitionId)
scope: storageAccount
properties: {
principalId: principalId
roleDefinitionId: roleDefinitionId
principalType: principalType
description: description
}
}
It would be wonderful if "serverFarms" was (searchable as) "appServicePlan" or "appService" or "asp"
I would be great to have a similar snippet for cosmosDbAccounts instead of Microsoft.DocumentDB/Accounts
What about snippets for the new public module resources? How would you pick when to use one versus the other? Should you let the community write snippet collections, instead of spending your time on it?
I would like to see logAnalytics
as a searchable term for Microsoft.OperationalInsights/workspaces
What about snippets for the new public module resources? How would you pick when to use one versus the other? Should you let the community write snippet collections, instead of spending your time on it?
Wassup @Jaykul , thanks for your question. Community members are always welcome to contribute! We're just trying to take a look at a first pass of adding functionality to support easier searching through resources. @alex-frankel What do you think about "searchability" of public resources? This is a good question
One thing we are planning to do for discovering public modules is to support completions for registry references.
This will show up when you type:
module foo '
At which point br/public
should show up in the list. Selecting that alias would then show the full list of available modules, similar to this list:
Do we think that goes far enough to help with discovery?
@puicchan Need list of aliases to support, thanks.
Snippet keywords
Snippet name | Add keyword | Notes |
---|---|---|
res-aks-cluster | k8s,kubernetes | Uche(above) |
Resource keywords
RP | Add keyword/alias |
---|---|
microsoft.web/sites | appservice, webapp, function |
microsoft.web/serverfarms | appserviceplan |
microsoft.app | containerapp |
microsoft.cache | redis |
microsoft.ContainerService | aks |
Microsoft.Web/sites: webapp Microsoft.Web/serverfarms: hosting plan