{hpc-cache} breadth coverage for hpc cache #1403

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

qianwens merged 13 commits into Azure:master from qianwens:master

Apr 7, 2020

.github/CODEOWNERS

Original file line number	Diff line number	Diff line change
Expand Up		@@ -91,3 +91,6 @@
		/src/powerbidedicated/ @Juliehzl

		/src/blueprint/ @fengzhou-msft

		/src/hpc-cache/ @qianwens

src/hpc-cache/HISTORY.rst

-Original file line number
+Diff line change
@@ -0,0 +1,8 @@
+    .. :changelog:
+    Release History
+    ===============
+.1.0
+    ++++++
+    * Initial release.

src/hpc-cache/README.md

-Original file line number
+Diff line change
@@ -0,0 +1,47 @@
+    Microsoft Azure CLI 'hpc-cache' Extension
+    ==========================================
+    ### How to use ###
+    Install this extension using the below CLI command
+    ```
+    az extension add --name hpc-cache
+    ```
+    ### Included Features
+    #### Create HPC cache
+    *Examples:*
+    ```
+    az hpc-cache create --resource-group "scgroup" --name "sc1" --location "eastus" \
+        --cache-size-gb "3072" --subnet "/subscriptions/{subscription_id}/resourceGroups/{re \
+        source_group}/providers/Microsoft.Network/virtualNetworks/{virtual_network_name}/sub \
+        nets/{subnet_name}" --sku-name "Standard_2G"
+    ```
+    #### Start/Stop HPC cache
+    *Examples:*
+    ```
+    az hpc-cache start --resource-group "scgroup" --name "sc1"
+    az hpc-cache stop --resource-group "scgroup" --name "sc1"
+    ```
+    #### Add blob storage target in HPC cache
+    *Examples:*
+    ```
+    az hpc-cache blob-storage-target add --resource-group "scgroup" --cache-name "sc1" --name \
+        "st1" --storage-account "/subscriptions/{subscription_id}/resourceGroups/{resource_group} \
+        /providers/Microsoft.Storage/storageAccounts/{acount_name}" \
+        --container-name "cn" --virtual-namespace-path "/test"
+    ```
+    #### Add nfs storage target in HPC cache
+    *Examples:*
+    ```
+    az hpc-cache nfs-storage-target add --resource-group "scgroup" --cache-name "sc1" \
+        --name "st1" --nfs3-target 10.7.0.24 --nfs3-usage-model WRITE_AROUND \
+        --junction namespace-path="/nt2" nfs-export="/export/a" target-path="/1" \
+        --junction namespace-path="/nt3" nfs-export="/export/b"
+    ```
+    #### Remove storage target in HPC cache
+    *Examples:*
+    ```
+    az hpc-cache storage-target remove --resource-group "scgroup" \
+        --cache-name "sc1" \
+        --name "st1"
+    ```

src/hpc-cache/README.rst

-Original file line number
+Diff line change
@@ -0,0 +1,5 @@
+    Microsoft Azure CLI 'hpc-cache' Extension
+    ==========================================
+    This package is for the 'hpc-cache' extension.
+    i.e. 'az hpc-cache'

src/hpc-cache/azext_hpc_cache/__init__.py

-Original file line number
+Diff line change
@@ -0,0 +1,32 @@
+    # --------------------------------------------------------------------------------------------
+    # Copyright (c) Microsoft Corporation. All rights reserved.
+    # Licensed under the MIT License. See License.txt in the project root for license information.
+    # --------------------------------------------------------------------------------------------
+    from azure.cli.core import AzCommandsLoader
+    from azext_hpc_cache._help import helps  # pylint: disable=unused-import
+    class StorageCacheCommandsLoader(AzCommandsLoader):
+        def __init__(self, cli_ctx=None):
+            from azure.cli.core.commands import CliCommandType
+            from azext_hpc_cache._client_factory import cf_hpc_cache
+            hpc_cache_custom = CliCommandType(
+                operations_tmpl='azext_hpc_cache.custom#{}',
+                client_factory=cf_hpc_cache)
+            super(StorageCacheCommandsLoader, self).__init__(cli_ctx=cli_ctx,
+                                                             custom_command_type=hpc_cache_custom)
+        def load_command_table(self, args):
+            from azext_hpc_cache.commands import load_command_table
+            load_command_table(self, args)
+            return self.command_table
+        def load_arguments(self, command):
+            from azext_hpc_cache._params import load_arguments
+            load_arguments(self, command)
+    COMMAND_LOADER_CLS = StorageCacheCommandsLoader

src/hpc-cache/azext_hpc_cache/_client_factory.py

-Original file line number
+Diff line change
@@ -0,0 +1,30 @@
+    # --------------------------------------------------------------------------------------------
+    # Copyright (c) Microsoft Corporation. All rights reserved.
+    # Licensed under the MIT License. See License.txt in the project root for license information.
+    # --------------------------------------------------------------------------------------------
+    def cf_hpc_cache(cli_ctx, *_):
+        from azure.cli.core.commands.client_factory import get_mgmt_service_client
+        from .vendored_sdks.storagecache import StorageCacheManagementClient
+        return get_mgmt_service_client(cli_ctx, StorageCacheManagementClient)
+    def cf_operations(cli_ctx, *_):
+        return cf_hpc_cache(cli_ctx).operations
+    def cf_skus(cli_ctx, *_):
+        return cf_hpc_cache(cli_ctx).skus
+    def cf_usage_models(cli_ctx, *_):
+        return cf_hpc_cache(cli_ctx).usage_models
+    def cf_caches(cli_ctx, *_):
+        return cf_hpc_cache(cli_ctx).caches
+    def cf_storage_targets(cli_ctx, *_):
+        return cf_hpc_cache(cli_ctx).storage_targets

src/hpc-cache/azext_hpc_cache/_help.py

-Original file line number
+Diff line change
@@ -0,0 +1,219 @@
+    # coding=utf-8
+    # --------------------------------------------------------------------------------------------
+    # Copyright (c) Microsoft Corporation. All rights reserved.
+    # Licensed under the MIT License. See License.txt in the project root for license information.
+    # --------------------------------------------------------------------------------------------
+    # pylint: disable=too-many-lines
+    # pylint: disable=line-too-long
+    from knack.help_files import helps  # pylint: disable=unused-import
+    helps['hpc-cache skus'] = """
+        type: group
+        short-summary: Commands to manage hpc cache skus.
+    """
+    helps['hpc-cache skus list'] = """
+        type: command
+        short-summary: Get the list of StorageCache.Cache SKUs available to this subscription.
+        examples:
+          - name: Skus_List
+            text: |-
+                   az hpc-cache skus list
+    """
+    helps['hpc-cache usage-model'] = """
+        type: group
+        short-summary: Commands to manage hpc cache usage model.
+    """
+    helps['hpc-cache usage-model list'] = """
+        type: command
+        short-summary: Get the list of Cache Usage Models available to this subscription.
+        examples:
+          - name: UsageModels_List
+            text: |-
+                   az hpc-cache usage-model list
+    """
+    helps['hpc-cache'] = """
+        type: group
+        short-summary: Commands to manage hpc cache.
+    """
+    helps['hpc-cache create'] = """
+        type: command
+        short-summary: Create or update a Cache.
+        examples:
+          - name: Caches_CreateOrUpdate
+            text: |-
+                   az hpc-cache create --resource-group "scgroup" --name "sc1" --location "eastus" \\
+                   --cache-size-gb "3072" --subnet "/subscriptions/{{ subscription_id }}/resourceGroups/{{ re
+                   source_group }}/providers/Microsoft.Network/virtualNetworks/{{ virtual_network_name }}/sub
+                   nets/{{ subnet_name }}" --sku-name "Standard_2G"
+    """
+    helps['hpc-cache update'] = """
+        type: command
+        short-summary: Create or update a Cache.
+        examples:
+          - name: Caches_Update
+            text: |-
+                   az hpc-cache update --resource-group "scgroup" --name "sc1" --location "eastus" \\
+                   --cache-size-gb "3072" --subnet "/subscriptions/{{ subscription_id }}/resourceGroups/{{ re
+                   source_group }}/providers/Microsoft.Network/virtualNetworks/{{ virtual_network_name }}/sub
+                   nets/{{ subnet_name }}" --sku-name "Standard_2G"
+    """
+    helps['hpc-cache delete'] = """
+        type: command
+        short-summary: Schedules a Cache for deletion.
+        examples:
+          - name: Caches_Delete
+            text: |-
+                   az hpc-cache delete --resource-group "scgroup" --name "sc"
+    """
+    helps['hpc-cache show'] = """
+        type: command
+        short-summary: Returns a Cache.
+        examples:
+          - name: Caches_Get
+            text: |-
+                   az hpc-cache show --resource-group "scgroup" --name "sc1"
+    """
+    helps['hpc-cache list'] = """
+        type: command
+        short-summary: Returns all Caches the user has access to under a resource group.
+        examples:
+          - name: Caches_List
+            text: |-
+                   az hpc-cache list
+          - name: Caches_ListByResourceGroup
+            text: |-
+                   az hpc-cache list --resource-group "scgroup"
+    """
+    helps['hpc-cache start'] = """
+        type: command
+        short-summary: Tells a Stopped state Cache to transition to Active state.
+        examples:
+          - name: Caches_Start
+            text: |-
+                   az hpc-cache start --resource-group "scgroup" --name "sc"
+    """
+    helps['hpc-cache stop'] = """
+        type: command
+        short-summary: Tells an Active Cache to transition to Stopped state.
+        examples:
+          - name: Caches_Stop
+            text: |-
+                   az hpc-cache stop --resource-group "scgroup" --name "sc"
+    """
+    helps['hpc-cache flush'] = """
+        type: command
+        short-summary: Tells a Cache to write all dirty data to the Storage Target(s). During the flush, clients will see errors returned until the flush is complete.
+        examples:
+          - name: Caches_Flush
+            text: |-
+                   az hpc-cache flush --resource-group "scgroup" --name "sc"
+    """
+    helps['hpc-cache upgrade-firmware'] = """
+        type: command
+        short-summary: Upgrade a Cache's firmware if a new version is available. Otherwise, this operation has no effect.
+        examples:
+          - name: Caches_UpgradeFirmware
+            text: |-
+                   az hpc-cache upgrade-firmware --resource-group "scgroup" --name "sc"
+    """
+    helps['hpc-cache wait'] = """
+        type: command
+        short-summary: Waits a hpc Cache to specified state.
+        examples:
+          - name: Caches_Wait
+            text: |-
+                   az hpc-cache wait --resource-group "scgroup" --name "sc" --created
+    """
+    helps['hpc-cache storage-target'] = """
+        type: group
+        short-summary: Commands to manage hpc cache storage target.
+    """
+    helps['hpc-cache blob-storage-target'] = """
+        type: group
+        short-summary: Commands to create hpc cache blob storage target.
+    """
+    helps['hpc-cache nfs-storage-target'] = """
+        type: group
+        short-summary: Commands to create hpc cache nfs storage target.
+    """
+    helps['hpc-cache blob-storage-target add'] = """
+        type: command
+        short-summary: Create or update a blob Storage Target. This operation is allowed at any time, but if the Cache is down or unhealthy, the actual creation/modification of the Storage Target may be delayed until the Cache is healthy again.
+        examples:
+          - name: StorageTargets_CreateOrUpdate
+            text: |-
+                   az hpc-cache blob-storage-target add --resource-group "scgroup" --cache-name "sc1" --name \\
+                   "st1" --storage-account "/subscriptions/{subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.Storage/storageAccounts/{acount_name}" \\
+                    --container-name "cn" --virtual-namespace-path "/test"
+    """
+    helps['hpc-cache blob-storage-target update'] = """
+        type: command
+        short-summary: Create or update a blob Storage Target. This operation is allowed at any time, but if the Cache is down or unhealthy, the actual creation/modification of the Storage Target may be delayed until the Cache is healthy again.
+    """
+    helps['hpc-cache nfs-storage-target add'] = """
+        type: command
+        short-summary: Create or update a nfs Storage Target. This operation is allowed at any time, but if the Cache is down or unhealthy, the actual creation/modification of the Storage Target may be delayed until the Cache is healthy again.
+        examples:
+          - name: StorageTargets_CreateOrUpdate
+            text: |-
+                   az hpc-cache nfs-storage-target add --resource-group "scgroup" --cache-name "sc1" --name \\
+                   "st1" --nfs3-target 10.7.0.24 --nfs3-usage-model WRITE_AROUND \\
+                   --junction namespace-path="/nt2" nfs-export="/export/a" target-path="/1" \\
+                   --junction namespace-path="/nt3" nfs-export="/export/b"
+    """
+    helps['hpc-cache nfs-storage-target update'] = """
+        type: command
+        short-summary: Create or update a nfs Storage Target. This operation is allowed at any time, but if the Cache is down or unhealthy, the actual creation/modification of the Storage Target may be delayed until the Cache is healthy again.
+    """
+    helps['hpc-cache storage-target remove'] = """
+        type: command
+        short-summary: Removes a Storage Target from a Cache. This operation is allowed at any time, but if the Cache is down or unhealthy, the actual removal of the Storage Target may be delayed until the Cache is healthy again. Note that if the Cache has data to flush to the Storage Target, the data will be flushed before the Storage Target will be deleted.
+        examples:
+          - name: StorageTargets_Delete
+            text: |-
+                   az hpc-cache storage-target remove --resource-group "scgroup" --cache-name "sc1" --name \\
+                   "st1"
+    """
+    helps['hpc-cache storage-target show'] = """
+        type: command
+        short-summary: Returns a Storage Target from a Cache.
+        examples:
+          - name: StorageTargets_Get
+            text: |-
+                   az hpc-cache storage-target show --resource-group "scgroup" --cache-name "sc1" --name \\
+                   "st1"
+    """
+    helps['hpc-cache storage-target list'] = """
+        type: command
+        short-summary: Returns a list of Storage Targets for the specified Cache.
+        examples:
+          - name: StorageTargets_List
+            text: |-
+                   az hpc-cache storage-target list --resource-group "scgroup" --cache-name "sc1"
+    """

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

{hpc-cache} breadth coverage for hpc cache #1403

Uh oh!

Diff view

Diff view

There are no files selected for viewing

Uh oh!