Nas 命令

nas 命令是对硬盘挂载(NAS)产品操作的接口,包括上传文件、下载文件、执行自定义命令等能力。

💡Tips:nas 相关的命令都是建立在函数计算挂载 NAS 服务的的前提下,所以在使用该命令时需要注意以下几点:

  • 需要开通 NAS 相关的服务 ,开通 NAS 服务可能会产生相对应的费用;
  • 对 NAS 操作时,需要注意函数计算挂载 NAS 的路径。例如 NAS 被挂载到了 /mnt/auto 目录上,那么在上传下载的时候,就需要指定 /mnt/auto,例如s nas upload ./demo.yaml /mnt/auto/

命令解析

当执行命令nas -h/nas --help时,可以获取帮助文档。

在该命令中,包括了四个子命令:

nas init 命令

nas init 命令,是初始化 NAS 的命令;通常在完成 s.yaml/s.yml 文档编写之后,在没有进行项目部署时,NAS 可能处于未被创建的过程,此时可以通过 nas init 命令初始化 NAS 相关内容,从而可以直接使用 NAS 相关能力。

当执行命令nas init -h/nas init --help时,可以获取帮助文档。

当前命令支持部分全局参数(例如-a/--access, --debug等),详情可参考 Serverless Devs 全局参数文档

操作案例

有资源描述文件(Yaml)时,可以直接执行s nas init 进行 NAS 相关内容初始化,初始化完成的输出示例:

fc-deploy-test: 
  userId:      10003
  groupId:     10003
  mountPoints: 
    - 
      serverAddr: 06c1e48887-rmm92.cn-hangzhou.nas.aliyuncs.com
      nasDir:     /fc-deploy-service
      fcDir:      /mnt/auto

nas upload 命令

nas upload 命令,是将本地文件上传到 NAS 系统中的命令。

当执行命令nas upload -h/nas upload --help时,可以获取帮助文档。

参数解析

参数全称参数缩写Yaml模式下必填参数含义
recursiver选填
overrideo选填

当前命令还支持部分全局参数(例如-a/--access, --debug等),详情可参考 Serverless Devs 全局参数文档

操作案例

有资源描述文件(Yaml)时,可以直接执行s nas upload 进行文件内容的上传,例如可以通过命令s nas upload ./template.yml /mnt/auto上传本地文件./template.yml到远端 NAS 挂载到函数计算的目录 /mnt/auto 中:

File [./template.yml] uploaded successfully.

如果需要上传文件夹,可以通过增加--recursive/-r参数实现,例如s nas upload ./code /mnt/auto -r

Dir [./code] uploaded successfully.

⚠️ 注意:在使用的时候,如果遇到文件已存在,需要按需通过--override/-o参数进行强制覆盖。

nas download 命令

nas download 命令,是将挂载在函数计算的 NAS 系统中的文件下载到本地。

当执行命令nas download -h/nas download --help时,可以获取帮助文档。

参数解析

参数全称参数缩写Yaml模式下必填参数含义
overrideo选填覆盖现有文件
no-unzip-选填不解压文件夹

当前命令还支持部分全局参数(例如-a/--access, --debug等),详情可参考 Serverless Devs 全局参数文档

操作案例

有资源描述文件(Yaml)时,可以直接执行s nas download 进行文件内容的下载,例如可以通过命令s nas download /mnt/auto/template.yml ./将远端 NAS 挂载到函数计算的目录 /mnt/auto 中文件./template.yml下载到本地目录./中:

File [/mnt/auto/template.yml] download successfully.

⚠️ 注意:在使用的时候,如果遇到文件已存在,需要按需通过--override/-o参数进行强制覆盖。

nas command 命令

nas command 命令,是在实例中执行特定指令的命令;例如通过 nas command 命令,在已经挂载 NAS 产品的函数实例中创建文件/文件夹/删除文件/文件夹等。

当执行命令nas command -h/nas command --help时,可以获取帮助文档。

支持部分全局参数(例如-a/--access, --debug等),详情可参考 Serverless Devs 全局参数文档

操作案例

有资源描述文件(Yaml)时,可以直接执行s nas command 在函数计算实例中进行命令的执行,例如可以通过命令s nas command ls /mnt/auto查看 NAS 中的目录内容:

code
template.yml

可以通过s nas command mkdir /mnt/auto/demo在 NAS 中创建文件夹 demo

权限与策略说明

子账号需要的权限

最大权限

系统策略AliyunFCFullAccessAliyunVPCFullAccessAliyunNasFullAccess

最小权限

执行命令时,需要检测、部署、调用辅助函数,如果执行 nas initnasConfigauto 需要创建 nas 的相关资源,因此需要如下权限:

系统策略AliyunNasReadOnlyAccess

自定义策略

{   
  "Statement":[
        {
            "Action":"fc:GetAccountSettings",
            "Effect":"Allow",
            "Resource":"acs:fc:<region>:<account-id>:account-settings"
        },
        {
            "Action":[
                "fc:UpdateService",
                "fc:CreateService"
            ],
            "Effect":"Allow",
            "Resource":"acs:fc:<region>:<account-id>:services/*"
        },
        {
            "Action":[
                "fc:InvokeFunction",
                "fc:CreateFunction",
                "fc:UpdateFunction"
            ],
            "Effect":"Allow",
            "Resource":"acs:fc:<region>:<account-id>:services/*/functions/*"
        },
        {
            "Action":[
                "fc:UpdateTrigger",
                "fc:CreateTrigger"
            ],
            "Effect":"Allow",
            "Resource":"acs:fc:<region>:<account-id>:services/*/functions/*/triggers/*"
        },
        {
            "Action":"ram:PassRole",
            "Effect":"Allow",
            "Resource":"*"
        },
        {
            "Action":[
                "nas:CreateMountTarget",
                "nas:DescribeMountTargets",
                "nas:DescribeFileSystems",
                "nas:CreateFileSystem",
                "vpc:DescribeVSwitchAttributes"
            ],
            "Effect":"Allow",
            "Resource":"*"
        }
    ],
    "Version":"1"
}

服务角色权限

系统策略AliyunECSNetworkInterfaceManagementAccess

在 GitHub 上编辑本页面 更新时间: Wed, Aug 10, 2022