diff --git a/docs/quick-answers/linode-platform/tags-and-groups/group-linode-tags.png b/docs/quick-answers/linode-platform/tags-and-groups/group-linode-tags.png new file mode 100644 index 00000000000..ea6a1cfd725 Binary files /dev/null and b/docs/quick-answers/linode-platform/tags-and-groups/group-linode-tags.png differ diff --git a/docs/quick-answers/linode-platform/tags-and-groups/index.md b/docs/quick-answers/linode-platform/tags-and-groups/index.md new file mode 100644 index 00000000000..71f1c1ecd33 --- /dev/null +++ b/docs/quick-answers/linode-platform/tags-and-groups/index.md @@ -0,0 +1,228 @@ +--- +author: + name: Linode Community + email: docs@linode.com +description: 'How to create tags to organize your Linode services.' +keywords: ['list','of','keywords','and key phrases'] +license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)' +published: 2019-02-22 +modified_by: + name: Linode +title: "Tags and Groups" +contributor: + name: Linode +--- + +Linode's [Cloud Manager](https://cloud.linode.com) and [API](https://developers.linode.com) allow you to create tags to help organize and group your Linode resources. Tags can be applied to Linodes, [Block Storage Volumes](/docs/platform/block-storage/how-to-use-block-storage-with-your-linode-new-manager/), [NodeBalancers](/docs/platform/nodebalancer/getting-started-with-nodebalancers-new-manager/), and [Domains](/docs/platform/manager/dns-manager-new-manager/). + +This guide will show you how to perform the following actions with the Cloud Manager: + +- Create and apply tags to your Linode resources +- Search and group your Linode resources by tag +- Import tags from the Classic Manager + +## Tagging a Linode + +### Tag a Linode at Creation + +To tag a Linode at the time of its creation: + +1. In the **Create New Linode** form, click the dropdown menu labeled **Add Tags** located below the **Linode Label** field. + +1. Select one or more tags from the menu. To create a new tag, type in the desired tag name and click the **Create "new-tag"** option that appears: + + ![Add Tags field in the Linode creation form](tags-new-linode.png "Select an existing tag or tags, or provide a new tag with the 'Add Tags' dropdown.") + +1. Your tag will be applied when you finish creating the Linode. + +### Tag an Existing Linode + +To tag an existing Linode: + +1. Navigate to the Linode's detail page. + +1. Click on the **Summary** tab. + +1. Locate the **Tags** pane and click on the **Add New Tag** option. + +1. Select one or more tags from the dropdown menu that appears. To create a new tag, type in the desired tag name and click the **Create "new-tag"** option that appears: + + ![Location of Tags box for a Linode](tags-existing-linode.png "Find the 'Tags' box and select an existing tag or tags, or type to add a new one.") + +### Remove a Tag from a Linode + +To remove a tag from a Linode: + +1. Navigate to the Linode's detail page. + +1. Click on the **Summary** tab. + +1. Locate the **Tags** box. A list of your tags for the Linode will be displayed. + +1. Click on the **X** icon attached to the tag you would like to remove from your Linode. + +## Tagging a Volume + +### Tag a Volume at Creation + +To tag a Volume at the time of its creation: + +1. In the **Create a Volume** form, select the dropdown menu labeled **Tags**. + +1. Select one or more tags from the menu. To create a new tag, type in the desired tag name and click the **Create "new-tag"** option that appears. + + ![Tags field in the Volume creation form](tags-new-volume.png "Select the tag you would like to use from the 'Tags' dropdown menu, or type to create a new tag") + +1. Once you are done configuring the Volume, click **Submit**. + +### Tag an Existing Volume + +To tag an existing Volume: + +1. Navigate to the Volumes page of the Cloud Manager. + +1. Select the more options **ellipsis (...)** corresponding to the Volume you would like to tag. + +1. Select **Edit Volume** from the menu that appears. + +1. The **Edit volume** form will appear. Click on the dropdown menu labeled **Tags**. + +1. Select one or more tags from the form. To create a new tag, type in the desired tag name and click the **Create "new-tag"** option that appears. + +1. When you are done, click **Submit**: + + ![Tags field in the Edit volume form](tags-existing-volume.png "Select the tag you would like to use from the 'Tags' dropdown menu, or type to create a new tag") + +### Remove a Tag from a Volume + +To remove a tag from a Volume: + +1. Navigate to the Volumes page of the Cloud Manager. + +1. Select the more options **ellipsis (...)** corresponding to the Volume whose tags you would like to edit. + +1. Select **Edit Volume** from the menu that appears. + +1. The **Edit volume** form will appear. A list of your tags for the Volume will be displayed in the **Tags** field. + +1. Click on the **x** icon attached to the tag you would like to remove from your Volume. + +## Tagging a NodeBalancer + +### Tag a NodeBalancer at Creation + +To tag a NodeBalancer at the time of its creation: + +1. In the **Create a NodeBalancer** form, click the dropdown menu labeled **Add Tags** under the **NodeBalancer Label** field. + +1. Select one or more tags from the menu. To create a new tag, type in the desired tag name and click the **Create "new-tag"** option that appears. + + ![Add Tags field in the NodeBalancer creation form](tags-new-nodebalancer.png "Select the tag you would like to use from the 'Add Tags' dropdown menu, or type to create a new tag.") + +1. Once you are done configuring the NodeBalancer, click **Create**. + +### Tag an Existing NodeBalancer + +To tag an existing NodeBalancer: + +1. Navigate to the NodeBalancer's detail page. + +1. Click on the **Summary** tab. + +1. Locate the **Tags** pane and click on the **Add New Tag** option. + +1. Select one or more tags from the dropdown menu that appears. To create a new tag, type in the desired tag name and click the **Create "new-tag"** option that appears: + + ![Location of Tags box for a NodeBalancer](tags-existing-nodebalancer.png "Find the 'Tags' box and either select an existing tag, or type in a new one.") + +### Remove a Tag from a NodeBalancer + +To remove a tag from a NodeBalancer: + +1. Navigate to the NodeBalancer's detail page. + +1. Click on the **Summary** tab. + +1. Locate the **Tags** pane. A list of your tags for the NodeBalancer will be displayed. + +1. Click on the **x** icon attached to the tag you would like to remove from your NodeBalancer. + +## Tagging a Domain + +### Tag a Domain at Creation + +To tag a domain at the time of its creation: + +1. In the **Add a new Domain** form, click the dropdown menu labeled **Add Tags**. + +1. Select one or more tags from the menu. To create a new tag, type in the desired tag name and click the **Create "new-tag"** option that appears: + + ![Tags field in the domain creation form](tags-new-domain.png "Select the tag you would like to use from the 'Tags' dropdown menu, or type to create a new tag.") + +### Tag an Existing Domain + +To tag an existing domain: + +1. Navigate to the domain's detail page. + +1. Click on the **DNS Records** tab. + +1. Locate the pane labeled **Tags** and click on the **Add New Tag** option. + +1. Select one or more tags from the dropdown menu that appears. To create a new tag, type in the desired tag name and click the **Create "new-tag"** option that appears: + + ![Location of Tags box for a domain](tags-existing-domain.png "Find the 'Tags' box and select an existing tag or tags, or type to add a new one.") + +### Remove a Tag from a Domain + +To remove a tag from a domain: + +1. Navigate to the domain's detail page. + +1. Click on the **DNS Records** tab. + +1. Locate the **Tags** pane. A list of your tags for the Domain will be displayed. + +1. Click on the **x** icon attached to the tag you would like to remove from your domain. + +## Grouping by Tag + +You can group the following resources by tag: Linodes, Volumes, NodeBalancers, and Domains. + +1. To group by tag, navigate to the resource's page and toggle the **Group by Tag** switch at the top of the page: + + ![Cloud Manager Group by Tag switch](tags-group-linodes.png "To group Linodes by tag, toggle the 'Group by Tag' box at the top of the Linodes page") + +1. You will now be able to view your resources grouped by tag: + + ![Group your Linodes by tag](group-linode-tags.png "View all your grouped by tags Linodes") + +## Searching by Tag + +You can search your Linode resources by a tag's name: + +1. Type the tag name into the search bar at the top of the Cloud Manager and the results will be populated in a dropdown list that appears: + + ![Cloud Manager tag search](tags-search-bar.png "Search for resources by tag") + +1. To see a more organized view of your tagged resources, click on the blue **View search results page** banner inside the dropdown list, or hit the **Enter** key on your keyboard. You will be taken to the search results page: + + ![Cloud Manager search results page](tags-search-results.png "The search results page") + +1. A second way to search by tag is to click on a tag wherever it appears in the Cloud Manager. For example, if you previously applied a tag named `tag-example` to one of your Linodes, clicking on that tag where it is displayed in the Linode's detail page will take you to the search results page for `tag-example`. + +## Importing Groups as Tags + +If you have used the Display Groups feature in the Classic Manager, you can import your Display Groups to the Cloud Manager as tags: + +1. Navigate to the **Account** page in the sidebar links menu, then click on the **Settings** tab. + +1. Expand the panel labeled **Import Display Groups as Tags** and then click **Import Display Groups**: + + ![Cloud Manager import display groups as tags](tags-import-groups.png "Import display groups from the Classic Manager with the 'Import Display Groups' button in Account Settings") + +1. A form will appear that lists your Display Groups and asks you to confirm the import action. To proceed, click the **Import Display Groups Now** button in this form. + + {{< note >}} +Importing your Display Groups is a **one-time** operation. If you don't have any Display Groups configured in the Classic Manager this feature will not appear in the Cloud Manager. +{{< /note >}} \ No newline at end of file diff --git a/docs/quick-answers/linode-platform/tags-and-groups/tags-existing-domain.png b/docs/quick-answers/linode-platform/tags-and-groups/tags-existing-domain.png new file mode 100644 index 00000000000..fb2b7aaee9c Binary files /dev/null and b/docs/quick-answers/linode-platform/tags-and-groups/tags-existing-domain.png differ diff --git a/docs/quick-answers/linode-platform/tags-and-groups/tags-existing-linode.png b/docs/quick-answers/linode-platform/tags-and-groups/tags-existing-linode.png new file mode 100644 index 00000000000..313424f53d3 Binary files /dev/null and b/docs/quick-answers/linode-platform/tags-and-groups/tags-existing-linode.png differ diff --git a/docs/quick-answers/linode-platform/tags-and-groups/tags-existing-nodebalancer.png b/docs/quick-answers/linode-platform/tags-and-groups/tags-existing-nodebalancer.png new file mode 100644 index 00000000000..65e252bbf68 Binary files /dev/null and b/docs/quick-answers/linode-platform/tags-and-groups/tags-existing-nodebalancer.png differ diff --git a/docs/quick-answers/linode-platform/tags-and-groups/tags-existing-volume.png b/docs/quick-answers/linode-platform/tags-and-groups/tags-existing-volume.png new file mode 100644 index 00000000000..4ee4a9fe21f Binary files /dev/null and b/docs/quick-answers/linode-platform/tags-and-groups/tags-existing-volume.png differ diff --git a/docs/quick-answers/linode-platform/tags-and-groups/tags-group-linodes.png b/docs/quick-answers/linode-platform/tags-and-groups/tags-group-linodes.png new file mode 100644 index 00000000000..c935230415e Binary files /dev/null and b/docs/quick-answers/linode-platform/tags-and-groups/tags-group-linodes.png differ diff --git a/docs/quick-answers/linode-platform/tags-and-groups/tags-import-groups.png b/docs/quick-answers/linode-platform/tags-and-groups/tags-import-groups.png new file mode 100644 index 00000000000..978f703986d Binary files /dev/null and b/docs/quick-answers/linode-platform/tags-and-groups/tags-import-groups.png differ diff --git a/docs/quick-answers/linode-platform/tags-and-groups/tags-new-domain.png b/docs/quick-answers/linode-platform/tags-and-groups/tags-new-domain.png new file mode 100644 index 00000000000..a162d5fb44f Binary files /dev/null and b/docs/quick-answers/linode-platform/tags-and-groups/tags-new-domain.png differ diff --git a/docs/quick-answers/linode-platform/tags-and-groups/tags-new-linode.png b/docs/quick-answers/linode-platform/tags-and-groups/tags-new-linode.png new file mode 100644 index 00000000000..8717ed4c365 Binary files /dev/null and b/docs/quick-answers/linode-platform/tags-and-groups/tags-new-linode.png differ diff --git a/docs/quick-answers/linode-platform/tags-and-groups/tags-new-nodebalancer.png b/docs/quick-answers/linode-platform/tags-and-groups/tags-new-nodebalancer.png new file mode 100644 index 00000000000..7a4750fd77c Binary files /dev/null and b/docs/quick-answers/linode-platform/tags-and-groups/tags-new-nodebalancer.png differ diff --git a/docs/quick-answers/linode-platform/tags-and-groups/tags-new-volume.png b/docs/quick-answers/linode-platform/tags-and-groups/tags-new-volume.png new file mode 100644 index 00000000000..a1748658f34 Binary files /dev/null and b/docs/quick-answers/linode-platform/tags-and-groups/tags-new-volume.png differ diff --git a/docs/quick-answers/linode-platform/tags-and-groups/tags-search-bar.png b/docs/quick-answers/linode-platform/tags-and-groups/tags-search-bar.png new file mode 100644 index 00000000000..2d212ae1b8c Binary files /dev/null and b/docs/quick-answers/linode-platform/tags-and-groups/tags-search-bar.png differ diff --git a/docs/quick-answers/linode-platform/tags-and-groups/tags-search-results.png b/docs/quick-answers/linode-platform/tags-and-groups/tags-search-results.png new file mode 100644 index 00000000000..a0c50336424 Binary files /dev/null and b/docs/quick-answers/linode-platform/tags-and-groups/tags-search-results.png differ