直接使用
请打开基于企业和团队如何使用PAI-DSW协作开发，并点击右上角 “ 在DSW中打开” 。
概述
PAI-DSW集成了开源JupyterLab、WebIDE等工具，并以插件化的形式进行深度定制化开发。您无需任何运维配置，即可进行Notebook编写、调试及运行Python代码。同时，PAI-DSW基于AI工作空间，提供了丰富的实例资源管理，以及权限管理等能力，助力企业和团队，实现多人的灵活协作开发。
本文针对企业和同队协作场景下，PAI-DSW的使用和管理功能进行简单介绍。
AI工作空间介绍
工作空间是PAI的顶层概念，为团队提供统一的计算资源管理及人员权限管理能力，目的就是为AI开发者提供支持团队协作的全流程开发工具及AI资产管理能力。 PAI平台在开通时，会自动给用户 创建默认的工作空间 关于AI工作空间的更多使用介绍，可参考文档：管理工作空间
操作账号授权：DSW通用权限
为了确保PAI-DSW能够正常提供服务，您需要确认当前操作主账号拥有DSW通用权限，通常在开通并创建默认工作空间时，会统一进行授权操作，您可以根据下文参考：检查账号是否关联AliyunPAIDSWDefaultRole这一角色来检查当前账号是否已经具有DSW通用权限，如果没有，您可参考下文单独进行授权操作。
- 进入DSW页面。
- 登录PAI控制台。
- 在概览页面选择目标地域。
- 在左侧导航栏单击工作空间列表，在工作空间列表页面中单击待操作的工作空间名称，进入对应工作空间内。
- 在工作空间页面的左侧导航栏选择模型开发和训练 > 交互式建模（DSW），进入DSW页面。
- 授权AliyunPAIDSWDefaultRole角色。
- 单击创建实例。
- 在角色授权对话框，单击去授权。
- 在云资源访问授权页面，单击同意授权。在云资源访问授权页面，系统自动配置PAI-DSW需要的关联角色，无需手动配置。
操作账号授权：主账号授权RAM用户部分DSW实例操作权限
阿里云主账号可以授权RAM用户部分PAI-DSW实例细化的操作权限，包括创建、启动、停止及删除EAS实例。操作如下。
- 登录RAM控制台。
- 创建自定义权限策略。
- 在左侧导航栏，选择权限管理 > 权限管理策略。
- 在权限管理策略页面，单击创建权限策略。
- 在创建权限策略页面，单击脚本编辑，输入策略内容，单击下一步。
- 在创建权限策略页面，配置参数。
- 点击确定。
- 为RAM用户授权细化的DSW操作权限。
- 在左侧导航栏，选择身份管理 > 用户。
- 在用户页面，单击操作列下的添加权限。
- 可选：在添加权限面板，单击自定义策略。
- 在选择权限下的文本框，输入DSW_Notebook_Access。
- 单击权限策略名称下的DSW_Notebook_Access，使其显示在已选择列表中。
- 单击确定。
PAI访问云产品授权：NAS
授权PAI访问相关云产品NAS时，PAI为您提供了一键授权入口，操作详情如下。
- 登录PAI控制台。
- 在左侧导航栏单击全部云产品依赖，在DSW功能模块下找到NAS。
- 在操作列查看NAS的授权状态。
- 如果还未授权，请单击操作列后的去授权，根据界面提示完成授权操作。
- 如果已完成授权，可单击操作列后的查看授权信息，查看授权的详细信息。
实例创建
当完成以上的工作空间创建操作，用户就可以进入工作空间，进行DSW实例的创建和管理。
通过控制台创建实例
- 进入DSW页面。
- 登录PAI控制台。
- 在概览页面选择目标地域。
- 在左侧导航栏单击工作空间列表，在工作空间列表页面中单击待操作的工作空间名称，进入对应工作空间内。
- 在工作空间页面的左侧导航栏选择模型开发和训练 > 交互式建模（DSW），进入DSW页面。
- 单击创建实例。
- 在配置实例向导页面，配置参数。
- 单击确认订单。
- 核对订单信息，勾选同意服务条款后，单击创建实例。
通过Python SDK创建实例
- 安装Python SDK
!pip install alibabacloud_tea_openapi !pip install alibabacloud_pai_dsw20210226
- 创建一个PAI-DSW实例 创建PAI-DSW实例时，需要使用阿里云账号的AccessKey。关于如何获取AccessKey，请参见获取AccessKey。创建实例的代码示例如下所示，关于更多接口的说明，请参见API参考。
from alibabacloud_pai_dsw20210226.client import Client from alibabacloud_pai_dsw20210226.models import * from alibabacloud_tea_openapi.models import Config # 初始化一个Client以访问PAI-DSW的API。 region = 'cn-hangzhou' client = Client( Config( access_key_id='<替换成您的AccessKey ID>', access_key_secret='<替换成您的AccessKey Secret>', region_id=region, endpoint=f'pai-dsw.{region}.aliyuncs.com' ) ) # 验证是否已经为PAI-DSW的服务账号授权。 response = client.get_authorization() authorized = response.body.authorized # 如果授权，则进行后续的创建操作。 if authorized: # 获取官方镜像列表。 images = client.list_images(ListImagesRequest(accelerator_type_equals="cpu")).body.images # 挑选其中一个镜像。 image = images[0] # 获取实例规格列表。 ecs_specs = client.list_ecs_specs(ListEcsSpecsRequest(accelerator_type_equals="cpu")).body.ecs_specs # 挑选其中一个实例规格。 ecs_spec = ecs_specs[0] # 声明PAI-DSW实例的属性。 request = CreateInstanceRequest( instance_name="myFirstInstance", image_id=image.image_id, ecs_spec=ecs_spec.instance_type) # 提交创建PAI-DSW实例。 response = client.create_instance(request) # 获取PAI-DSW实例ID。 instance_id = response.body.instance_id # 查询PAI-DSW实例状态。 instance = client.get_instance(instance_id).body print('instance status:', instance.instance_status)
实例管理
用户可针对已创建的DSW实例，进行相关的管理操作。
停止实例
- 进入交互式建模（DSW）。
- 单击对应实例操作列下的停止。
- 在执行停止操作的确认对话框，选择停止方式。PAI-DSW实例支持两种停止方式：
- 保存环境然后停止：如果您对默认环境进行了修改（例如安装了软件包或pip包），建议选择该方式。
- 直接停止：如果未修改默认环境，通常选择直接停止。
实例停止后，其状态变为停止，此时对于后付费实例，系统停止计费。退出PAI-DSW时，确保您的实例处于停止状态，否则可能产生不必要的费用。
为了避免实例启动后忘记关闭，可同时配置“自动停止设置”，使得实例可以在指定时间后自动关闭，以停止计费。
启动实例
如果实例处于停止状态，则可以手动启动。
- 进入交互式建模（DSW）。
- 单击对应实例操作列下的启动。 实例启动后，其状态变为运行中，此时对于后付费实例，系统开始计费。完成训练后，建议您及时停止实例，以免产生不必要的费用。
删除实例
如果不再进行训练，则可以删除实例。实例删除后，其数据无法恢复。
- 进入交互式建模（DSW）。
- 单击对应实例操作列下的删除。
- 在删除对话框，单击确定
实例共享
实例准备
DSW支持实例共享，允许同一个工作空间内的多个成员共享使用同一个DSW实例。
要共享的实例，需要在实例创建阶段进行配置，详细步骤为：
- 进入DSW页面。
- 登录PAI控制台。
- 在概览页面选择目标地域。
- 在左侧导航栏单击工作空间列表，在工作空间列表页面中单击待操作的工作空间名称，进入对应工作空间内。
- 在工作空间页面的左侧导航栏选择模型开发和训练 > 交互式建模（DSW），进入DSW页面。
- 单击创建实例。
- 在配置实例向导页面，配置参数。
可以通过设置以下参数，来将实例与他人分享：
参数默认为“仅自己可见”，当选择“工作空间内公开可见”后，可对同一工作空间的所有成员可见。
- 单击确认订单。
- 核对订单信息，勾选同意服务条款后，单击创建实例。
工作空间成员管理
在工作空间详情页面，单击工作空间成员后面的编辑，即可进入成员管理面板。
- 进入成员管理面板。
- 在成员管理面板，单击添加成员。
- 在添加成员对话框，配置如下参数。
Fig.3 - 管理工作空间成员
