diff --git a/site/content/en/docs/manual/basics/attach-cloud-storage.md b/site/content/en/docs/manual/basics/attach-cloud-storage.md new file mode 100644 index 000000000000..70c8a930aa52 --- /dev/null +++ b/site/content/en/docs/manual/basics/attach-cloud-storage.md @@ -0,0 +1,62 @@ +--- +title: 'Attach cloud storage' +linkTitle: 'Attach cloud storage' +weight: 21 +description: 'Instructions on how to attach cloud storage using UI' +--- + +In CVAT you can use AWS-S3 and Azure Blob Container cloud storages to store image datasets for your tasks. +Initially you need to create a manifest file for your image dataset. Information on how to do that is available +on the [Simple command line to prepare dataset manifest file](/docs/manual/advanced/dataset_manifest) page. + +After the manifest file has been created, you can upload it and your dataset to an AWS-S3 or +Azure Blob Container cloud storage. + +After that you will be able to attach a cloud storage. To do this, press the `Attach new cloud storage` +button on the `Cloud storages` page and fill out the following form: + +![](/images/image228.jpg) + +- `Display name` - the display name of the cloud storage. +- `Description` (optional) - description of the cloud storage, appears when you click on the `?` button +of an item on cloud storages page. +- `Provider` - choose provider of the cloud storage: + + - [AWS-S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html): + + - `Bucket` - cloud storage bucket name + + - [`Authorization type`](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-best-practices.html): + + - `Key id and secret access key pair`: + - `ACCESS KEY ID` + - `SECRET ACCESS KEY ID` + + - `Anonymous access` + + - `Region` - here you can choose a region from the list or add a new one. To get more information click + on [`?`](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html#concepts-available-regions) + +
+ + - [Azure Blob Container](https://docs.microsoft.com/en-us/azure/storage/blobs/): + + - `Container name` - name of the cloud storage container + + - `Authorization type`: + + - [`Account name and SAS token`](https://docs.microsoft.com/en-us/azure/cognitive-services/translator/document-translation/create-sas-tokens?tabs=blobs): + + - `Account name` + - `SAS token` + + - [`Anonymous access`](https://docs.microsoft.com/en-us/azure/storage/blobs/anonymous-read-access-configure?tabs=portal) + - `Account name` + +
+- `Manifest` - the path to the manifest file on your cloud storage. +You can add multiple file manifests using the `Add manifest` button. +For more information click on [`?`](/docs/manual/advanced/dataset_manifest/). + +To publish the cloud storage, click `submit`, after which it will be available on +the [Cloud storages page](/docs/manual/basics/cloud-storages/). diff --git a/site/content/en/docs/manual/basics/cloud-storages.md b/site/content/en/docs/manual/basics/cloud-storages.md new file mode 100644 index 000000000000..bf259ec6ea00 --- /dev/null +++ b/site/content/en/docs/manual/basics/cloud-storages.md @@ -0,0 +1,23 @@ +--- +title: 'Cloud storages page' +linkTitle: 'Cloud storages page' +weight: 20 +description: 'Overview of the cloud storages page.' +--- + +![](/images/image227.jpg) + +The cloud storages page contains elements, each of them relating to a separate cloud storage.  +Each element contains: preview, cloud storage name, provider, creation and update info, status, +`?` button for displaying the description and the actions menu. + +Each button in the action menu is responsible for a specific function: +- `Update` — update this cloud storage +- `Delete` — delete cloud storage. + +![](/images/cloud_storage_icon.jpg) + +This preview will appear when it is impossible to get a real preview (e.g. storage is empty or +invalid credentials were used). + +Click the `Attach a new storage` button to [attach a new storage](/docs/manual/basics/attach-cloud-storage/). diff --git a/site/content/en/docs/manual/basics/creating_an_annotation_task.md b/site/content/en/docs/manual/basics/creating_an_annotation_task.md index ebd26bde4fba..82a6cab9758a 100644 --- a/site/content/en/docs/manual/basics/creating_an_annotation_task.md +++ b/site/content/en/docs/manual/basics/creating_an_annotation_task.md @@ -76,6 +76,9 @@ If you select tab `Connected file share` you can choose files for annotation fro If you select ` Remote source` , you'll see a field where you can enter a list of URLs (one URL per line). If you upload a video or dataset with images and select `Use cache` option, you can attach a `manifest.jsonl` file. You can find how to prepare it [here](/docs/manual/advanced/dataset_manifest/). +If you select the `Cloud Storage` tab, you can select a cloud storage (for this type the cloud storage name), +after that choose the manifest file and select the required files. +For more information on how to attach cloud storage, see [attach cloud storage](/docs/manual/basics/attach-cloud-storage/) ![](/images/image127.jpg) diff --git a/site/content/en/images/cloud_storage_icon.jpg b/site/content/en/images/cloud_storage_icon.jpg new file mode 100644 index 000000000000..c863fc9f8325 Binary files /dev/null and b/site/content/en/images/cloud_storage_icon.jpg differ diff --git a/site/content/en/images/image127.jpg b/site/content/en/images/image127.jpg index 7ee24652e9fa..a2b2155b823a 100644 Binary files a/site/content/en/images/image127.jpg and b/site/content/en/images/image127.jpg differ diff --git a/site/content/en/images/image227.jpg b/site/content/en/images/image227.jpg new file mode 100644 index 000000000000..0e8e7126cf30 Binary files /dev/null and b/site/content/en/images/image227.jpg differ diff --git a/site/content/en/images/image228.jpg b/site/content/en/images/image228.jpg new file mode 100644 index 000000000000..d188005581d8 Binary files /dev/null and b/site/content/en/images/image228.jpg differ