在此页:
目标用户:
CAST AI 管理员
什么是CAST AIC门户?
CAST AIC门户是一个web应用,旨在支持交付管理员交付应用源代码——访问时,CAST AIC门户将支持注册新应用进行分析,并支持使用CAST交付管理器工具(DMT)交付源代码(专用于CAST提供的用于提取和交付源代码的工作站工具)。
因此,多个交付管理员可以在自己的本地机器上运行CAST交付管理器工具,并且可以选择只打包所需的源代码。交付管理员打包的源代码存储在由CAST AIC门户管理的中央位置,然后由AI管理员使用CAST 管理器检索该中心位置(配置为从CAST AIC门户中定义的同一个中心存储位置检索源代码)。更多详细信息,请参见源代码交付-介绍。
CAST AIC门户以.WAR文件(CAST-AICP.war)形式提供,用于部署在受支持的应用服务器(例如Apache Tomcat)上。标准部署类似于CAST工程仪表盘/发现门户的部署(详见部署CAST web 应用)。
请注意,与以前的CAST AIP版本相反,CAST AIC门户是这个版本中的强制安装:应用只能通过CAST AIC门户创建。
需要安装多少个CAST AIC门户?
CAST建议使用CAST AIC门户来管理需要使用CAST分析所有应用的源代码。然而CAST AIC门户支持CAST AIP版本,只能管理使用CAST AIP相同版本的应用(换句话说,例如——不能混合使用CAST AIP 8.2.x管理的应用和在CAST AIP 8.3.x上管理的应用)。
用于部署CAST AIC门户的特定使用案例
下面列出在部署CAST AIC门户时可能遇到的各种使用案例:
交付管理人员完全位于CAST AIC门户相同的内部网络上
CAST AIC门户安装在内部网络的一台机器上,可以通过内部网络上的URL访问。除了遵循本页的安装说明之外,不需要做更多的工作——这是标准的部署场景。
交付管理人员与CAST AIC门户位于相同的内部网络上,也位于公司防火墙之外
在本例中,拥有位于内部和外部(即本地网络)的交付管理器。这是一个更高级的部署场景。这个设置包括:
- 安装CAST AIC门户,详见本页面
- 另外,以反向代理模式将Apache Web服务器安装为面向公共的服务器,这样外部用户就可以通过internet访问内部资源(即安装在Apache Tomcat上的CAST AIC门户)。
- 另外,设置一个完全限定的域名,所有交付管理人员(无论是内部的还是外部的)都可以使用该域名通过Apache Web服务器访问CAST AIC门户。例如:http://aicportal.company.com。
- 可能还需要设置一个DMZ来放置Apache Web服务器,或者配置端口转发来允许外部用户访问Apache Web服务器。
可以在Apache Web服务器上设置反向代理中了解更多关于在反向代理中将Apache Web服务器安装为面向公共服务器的信息。
特定的配置注意事项和先决条件
CAST AIC门户具有一些特定的配置设置和先决条件,在继续安装之前需要解决这些问题:
源代码交付文件夹
源代码交付-介绍中解释,为了正确运行,CAST AIC门户需要一个交付文件夹:一个用于存储应用源代码的连续和压缩版本的中心位置,这些源代码由交付管理器使用CAST 交付管理工具(通过CAST AIC门户)打包。
这个文件夹还必须对CAST 管理器可用,以便访问交付管理器交付的代码。请参见交付文件夹应该位于何处获取更多信息。
如果使用的是CAST管理器的多个实例(使用多个管理服务),可以允许与相同的CAST AIC门户交互(即相同的交付文件夹),这并没有数据损坏的风险(但是注意,只有一个实例的CAST管理器应该管理一个单一的管理服务)。
其它注意事项和先决条件
机器 | CAST AIC门户可以托管在本地网络中的任何机器上:
| |
Java JRE | 必须安装在将承载应用服务器的机器上。请参见:
| |
应用服务器 | 必须安装在兼容的机器上。请参见:
注意:
| |
Web 浏览器 | 访问CAST AIC门户所需。有关Web浏览器兼容性,请参见支持的平台。 | |
WAR 文件 | CAST AIC门户是作为.WAR文件(CAST-AICP.war)提供的,可以从CAST安装文件夹中的WARS文件夹中检索: |
预安装检查列表
在开始安装程序前,请确保已完成下列所有工作,并符合下列要求:
请确保已经阅读了所有CAST产品版本发布信息,以获取最新的信息。 | |
决定将在何处安装CAST AIC门户——CAST管理工作站、单独的专用机器或用于其它CAST AIP web应用的机器。 | |
确保知道源代码交付文件夹的位置。 | |
确保目标计算机上的用户登录具有足够的用户权限来安装应用 (参见 附录- CAST管理工作站的安装和硬件要求)。 | |
确保已经为部署准备好所需的.WAR文件。 |
安装过程
本文假设在Windows环境中使用Apache Tomcat来托管CAST AIC门户。
安装过程分为以下几个步骤:
步骤1: 部署和配置应用服务器上的CAST-AICP.war文件
部署WAR文件
定位CAST-AICP.war文件,并将其移动到web应用安装位置。在Apache Tomcat上默认设置为:
%CATALINA_HOME%\webapps
- 如果Apache Tomcat服务器正在运行,那么.WAR文件将被解压并部署到一个名为“CAST-AICP”的文件夹中。
- 现在应该能够使用以下URL访问CAST AIC门户(如果应用服务器被配置为接受端口80上的请求,则可以省略<port_number>):
http://<server_name>:<port_number>/CAST-AICP
定义源代码交付文件夹
当第一次访问CAST AIC门户时,将看到以下消息:
"在web.xml中没有定义源代码交付文件夹路径。请更新web.xml并重新启动CAST AIC门户。"
- 这表示尚未定义源代码交付文件夹,需要这样做才能访问CAST AIC门户。
- 为此,用文本编辑器编辑web.xml文件(它位于Apache Tomcat):
%CATALINA_HOME%\webapps\CAST-AICP\WEB-INF\web.xml
- 在web.xml中找到以下条目:
<!-- <context-param> <param-name>sourceCodeDeliveryFolder</param-name> <param-value>[sourceCodeDeliveryFolderPath]</param-value> </context-param> -->
- 通过以下方式修改此条目:
- 删除 <!-- and --> 注释标记——如果忘记这样做,整个条目将保留在注释中,并将被忽略。
- 将<param-value>值指向源代码交付文件夹的位置,如下所示:
<context-param> <param-name>sourceCodeDeliveryFolder</param-name> <param-value>D:\CAST\DELIVERY</param-value> </context-param>
- 根据源代码交付文件夹的位置,可以使用以下语法:
类型 | 语法示例 | 注意 |
---|---|---|
驱动器的路径 | D:\CAST\DELIVERY (位于主机本地的文件夹) | 当CAST AIC门户和交付文件夹位于同一台机器上时,请使用此语法。在这种情况下,总是输入一个包含交付文件夹的本地驱动器的绝对路径(例如D:\ CAST\DELIVERY)。 请不要使用映射驱动器路径指向本地机器或远程网络共享的文件夹(使用Windows GUI或subst Windows命令创建)——这样做可能会导致错误,使CAST AIC门户无法正常工作。 |
UNC 路径 | \\HOST\CAST\DELIVERY (远程网络共享上的文件夹) | 只有当CAST AIC门户和交付文件夹位于不同机器上时,才使用此语法。 注意,前斜杠也会起作用。 |
- 更改完成后,保存web.xml文件,然后重新启动应用服务器以便更改生效。
测试对CAST AIC门户的访问
现在应该能够使用以下URL访问CAST AIC门户(将其修改为自己的环境):
http://<server_name>:<port_number>/CAST-AICP
请注意,即使已经部署了CAST 交付管理工具(即在Windows桌面上创建了快捷方式),CAST AIC门户仍然应该在主机应用服务器上运行。以这种方式启动CAST 交付管理工具时,需要CAST AIC门户将数据同步到源代码交付文件夹。
在反向代理服务器之后运行CAST AIC门户的可选配置
当用户拒绝直接访问CAST AIC门户,并由反向代理处理不同的公共URL时,就会出现这种情况。例如CAST AIC门户驻留在Tomcat服务器上,端口8443上打开HTTPS。然后,反向代理通过https://aicportal.castsoftware.com(参见 在Apache Web服务器上设置反向代理)在端口443上提供CAST AIC门户,以获得更多信息 。
如果希望以这种方式配置CAST AIC门户,则需要对CAST AIC门户进行附加的配置更改。
- 在位于%CATALINA_HOME%\webapps\CAST-AICP\WEB-INF\web.xml中的web.xml找到以下条目。
<!-- <context-param> <param-name>publicUrl</param-name> <param-value>http[s]://proxy-host[:proxy-port]/path-to-aicportal</param-value> </context-param> -->
- 通过以下方式修改此条目:
- 删除 <!-- and --> 注释标记——如果忘记这样做,整个条目将保留在注释中,并将被忽略。
- 将<param-value>值指向CAST AIC门户的公共URL,如下例所示:
<context-param> <param-name>publicUrl</param-name> <param-value>https://aicportal.castsoftware.com</param-value> </context-param>
- 更改完成后,保存web.xml文件,然后重新启动应用服务器以便更改生效。
步骤2: 配置用户身份验证
步骤2涉及配置用户如何使用CAST AIC门户进行身份验证,以下载CAST 交付管理工具并交付源代码。大多数组织选择LDAP/Active Directory集成,这样用户就可以使用公司用户名/密码访问所需的资源。CAST AIC门户还具有内置的用户名/密码身份验证机制,可以“开箱即用”。
有关更多信息,请参见配置用户身份验证。
附加信息
安装CAST AIC门户之后,可以了解更多关于如何创建域和应用以及如何向应用中添加交付管理器的信息,如下所示:
可以找到有关CAST AIC门户的高级安全配置更改的附加信息,如:
关于在Web应用部署常见安全配置选项中为应用服务器实现公共安全配置选项的附加信息: