Skip to content

Latest commit

 

History

History
183 lines (102 loc) · 9.54 KB

7.md

File metadata and controls

183 lines (102 loc) · 9.54 KB

从Web浏览器监控Bot

托管在您服务器上的网站提供bot的活动摘要，以及集成的详细信息。从bot的网站上，您和您的团队可以查看bot的活动并下载产品的构建和归档文件。（产品只包括app，归档包含Xcode项目）。

指定谁可以查看和使用bot网站

  1. 在Server的侧边栏服务列表上，选择Xcode。
![ServicesSidebar_2x.png](resources/FA6F1209716C9E001AFC404522730A50.png)
  1. 在Xcode面板上，单击Settings标签。
![server_xcode_settings_tab_2x.png](resources/2DFDC71A4B899839AEF0FA691194ADBA.png)
  1. 单击Edit Permissions。
![server_xcode_settings_tab_editpermissions_2x.png](resources/1A76E5DEB4A802A38D1E27EE2C88407B.png)
  1. 当对话框出现时，指定谁可以创建和查看bot，还有下载归档和产品。
![BotPermissions_2x (1).png](resources/E036E165141A531D1C655700D8140AD8.png)

- 如果您从弹出菜单中选择"all users"，所有访问网站的访问者都可以查看bot并下载项目。
- 如果您选择"logged in users"或者"only some users",未经验证的用户查看bot主页将不显示数据。网页左上角有一个登录按钮允许用户通过可用的用户名和密码登录。（关于在server上创建账户，请参阅[Set Up Xcode Server for Team Members](https://developer.apple.com/library/content/documentation/IDEs/Conceptual/xcode_guide-continuous_integration/adopt_continuous_integration.html#//apple_ref/doc/uid/TP40013292-CH3-SW5)（[中文文档](2.md)））。
- 如果您选择"only some users"，则会看到一个用户和组表。添加和删除用户和组来满足您的需要。
  1. 要允许或限制只能查看网站的访问权限，在弹出菜单中使用"Also allow view-only access for"和"Allow connections from"。
用户只可查看权限的用户可以访问网站并开启集成，但是他们不能创建和管理bot。特别受益于具有只访问bot活动的权限的人员是软件测试人员，项目经理和项目协调员。

查看bot网站

要查看bot网站，在web浏览器中导航至地址_hostname/xcode/_,_hostname_是服务器的网络域名（比如server.mycompany.com）或者其本地主机名（比如server.local）。根据在Xcode Server中配置的查看权限，可能会提示您使用本地或Open Directory账户凭据登录。

bot主页（图7-1）显示了在服务器上运行的bot的最近的集成摘要列表。

图7-1 bot网站

bot网站也可以从Server应用中访问。

从OS X Server应用中访问bot网站

  1. 在Server的侧边栏服务列表上，选择Xcode。
![ServicesSidebar_2x.png](resources/FA6F1209716C9E001AFC404522730A50.png)
  1. 在Xcode面板上，单击Settings标签。
![server_xcode_settings_tab_2x.png](resources/2DFDC71A4B899839AEF0FA691194ADBA.png)
  1. 在设备列表下方，点击"View bots"按钮。
![server_xcode_settings_tab_devices_table_view_bots_button_2x.png](resources/89ECD3C7BB7BF66DC3AB2B184CF467EE.png)

web浏览器将会打开并跳转到bot网站。

您也可以从您的开发Mac上的报告导航器中访问bot网站。

从报告导航器中访问bot网站

  1. 在您开发Mac的Xcode中，选择View > Navigators > Show Report Navigator。
![xcode_report_navigator_sidebar_2x.png](resources/4C318B7BDCF1C946D87B2126854B507E.png)
  1. 在报告导航器顶部点击By Group。
![xcode_report_navigator_by_group_button_2x.png](resources/2EBEB60008F99307FAD694D629D3F008.png)

所有的集成都通过bot名称进行分组。
  1. 在报告导航器中按住Control点击bot，从快捷菜单中选择View Bot in Browser。
![xcode_report_navigator_view_bot_in_browser_contextual_menu_2x.png](resources/40337B8039D614A343CAA9247B62D149.png)

web浏览器将会打开并跳转到bot网站。

从bot网站上登出

  • 在bot主页左上角点击Log Out按钮。

    bots_website_logout_2x.png

从bot网站上监测Bot

您可以在bot主页上通过轻触或点击一个bot或集成来查看最近bot的集成摘要。

过滤bot集成

  1. 在bot主页的标题中心单击过滤按钮。
  2. 从弹出菜单中选择需要的条件来过滤集成列表。
![bots_website_filtering_2x.png](resources/67507F9574268C538091656783503B21.png)

- _Latest_显示每个bot最近完成的集成。
- _Failed_显示每个bot最近失败的集成。
- _succeeded_显示每个bot最近成功的集成。
- _Flagged_显示每个bot最近被标记的集成。

当您进行选择后，主页的标题将显示活跃的过滤调节。

查看bot的集成结果

  • 在bot主页的列表上点击bot或集成的名称。

    bots_website_integration_detail_2x.png

    将会显示由bot执行的最近集成的摘以及提交。

    您可以点击标记按钮来标记一个特定的集成以作区分，例如，作为发布候选版本。标记的意义取决于您和您的组织。

    bots_website_integration_flag_2x.png

从Bot网站打开Xcode中的bot

bot网站提供了一个途径来快速打开您开发Mac上Xcode中的bot。

打开一个Xcode中的bot

  1. 当在您的开发Mac中查看bot网站时，单击bot主页列表上任意的bot或集成。您的浏览器窗口将会显示bot最近执行的集成的摘要。
  2. 点击"Open in Xcode"链接。
![bots_website_open_in_xcode_button_2x.png](resources/4D14A7985A6BC22F752AB4588AA581E2.png)

Xcode将会打开这个bot。

从bot网站上下载集成文件

bot网站有助于向测试人员和其他团队成员分发产品文件，构建和归档（如果适用）。产品只包含应用程序，而归档包含Xcode项目。

在OS X中下载集成日志和文件

  1. 点击bot主页列表上任意的bot或集成名称。您的浏览器窗口将会显示bot最近执行的集成的摘要。
  2. 点击Download链接来下载集成的日志和文件。
![bots_website_download_button_2x.png](resources/6AE2B9A1A5481055E780300BA4BA20E9.png)

在OS X中下载集成的归档

  1. 点击bot主页列表上任意的bot或集成名称。您的浏览器窗口将会显示bot最近执行的集成的摘要。
  2. 如果可用，点击Archive链接，下载产品的归档文件（Xcode项目）。
![bots_website_archive_button_2x.png](resources/DA134E0344CF89713855CB74B016F5BD.png)

如果集成没有包含Archive链接，集成则未带有归档文件。

在OSX中下载集成产品

  1. 点击bot主页列表上任意的bot或集成名称。您的浏览器窗口将会显示bot最近执行的集成的摘要。
  2. 如果可用，点击Product链接，下载产品的产品（应用程序）。
![bots_website_product_button_2x.png](resources/005D3B9A4ECA2571FF609E1E9BA1E190.png)

如果集成没有包含Production链接，集成则未带有产品文件。

从Bot网站安装iOS产品

对于iOS产品，bot网站允许为集成以及产品（应用程序）本身安装Over-the-Air产品安装所需的配置文件。如果bot是一个iOS项目并且集成包含产品，蓝色或绿色的安装按钮将会出现在集成摘要界面。蓝色安装按钮表明需要安装Xcode Server Over-the-Air安装配置文件，绿色安装按钮表明产品可以直接安装。

在iOS设备上安装集成的Over-the-Air安装配置文件

  1. 点击bot主页列表上任意的bot或集成名称。您的浏览器窗口将会显示bot最近执行的集成的摘要。
  2. 点击蓝色安装按钮来安装集成的应用。
![bots_website_install_profile_button_2x.png](resources/B1456FA0325DCA0A37C474EC46DCFEC5.png)

当您安装好配置文件后，安装按钮的颜色会从蓝色变为绿色，表明现在可以安装产品。

在iOS设备上安装集成的产品（应用程序）

  • 当安装好集成的配置文件后（参考以上说明），单击绿色安装按钮来安装产品。

    bots_website_install_app_button_2x.png

在Big Screen上查看您的bot

要在大型或专用显示器上显示bot的状态，请使用Big Screen查看。

在Big Screen上查看bot

执行以下操作之一：

  • 显示Big Screen网站——hostname/xcode/bigscreen，_hostname_是服务器的网络域名（比如server.mycompany.com）或者其本地主机名（比如server.local）。

  • 点击bot主页右上角的Big Screen按钮。

    bots_website_big_screen_button_2x.png

网页可以全屏，也可以通过AirPlay镜像显示。Big Screen循环显示所有服务器的bot，每个bot只显示最相关的状态信息。bot列表及其最近完成的结果显示在左侧。对于正在循环的bot将会显示错误、警告、提交和测试数量。通过加号（+）或减号（-）来标识相对于之前集成数量的增加和减少。

对于bot的集成，提交者名字首字母显示并包含在一个白色圆圈内。这个圆圈表明对于当前集成，提交者相对于所有提交贡献的代码量。彩色的圆圈标识提交者贡献的代码导致的问题量（如果有的话）。红色菱形表示错误，黄色三角形表示警告，蓝色方块表示静态分析问题。参考图7-2.

图7-2 持续集成服务器的Big Screen