Nexus使用Api进行操作

Nexus提供了RestApi,但是一部分Api仍然需要结合Groovy等进行操作,在3.3及其以后的版本上进行了强化,但是和普通的RestApi相比仍有一些“使用上的特性”。这篇文章以创建raw的repository为例,来确认一下相关的使用方法。

前提准备

准备可运行的Nexus,这里的版本为3.2.1

Nexus使用Api进行操作

Api机制

这篇文章介绍的是Nexus3推出之初的Api的设计思路,主要是通过结合groovy脚本来完成相关的功能,简单的来说需要用户自行提供groovy脚本,nexus提供上传和运行脚本的接口,虽然有些粗糙,但是大部分功能毕竟留出了一个方式供用户去使用,强大的groovy脚本中至于需要实现什么样的功能,那就看用户自己的需要了。在一定程度上来说,算是一个能够创造API的API

使用步骤

步骤1: 以json文件为载体,创建可运行的groovy脚本

格式大体如下:

{
 "name": "脚本名称",
 "type": "groovy",
 "content": "groovy语句"
}

注意事项:

  • 注意双引号和单引号的使用
  • 脚本的名称会成为后续API的一部分,请注意命名

步骤2: 上传json文件

使用如下方式和接口即可上传相应包含groovy操作的json文件

  • 接口:/service/siesta/rest/v1/script
  • 方法:POST
  • 文件:将步骤1中准备的文件作为POST的内容传入

步骤3: 执行groovy文件

使用如接口即可执行在步骤2中上传的groovy脚本

  • 接口:/service/siesta/rest/v1/script/脚本名称/run
  • 方法:POST

此处需要注意脚本名称也会是执行接口中的一部分,命名变得灰常重要。

使用示例

这里使用上述方式来演示一下如何在Nexus中创建一个Raw类型的repository。

步骤1: 以json文件为载体,创建可运行的groovy脚本

因为创建repository需要指定blob,如果没有指定则会使用default,但是如果项目众多,将会导致default非常巨大,在前面介绍nexus的使用实践中也给出过对于不同的repository创建自己的blob,所以这里创建如下的json文件:

liumiaocn:~ liumiao$ cat rawrepotest1.json 
{
 "name": "rawrepotest1",
 "type": "groovy",
 "content": "def rawStore = blobStore.createFileBlobStore('rawrepotest1', 'raw');repository.createRawHosted('rawrepotest1', rawStore.name);"
}
liumiaocn:~ liumiao$

建议:因为Nexus的这种使用方式本身就不是非常完整的方式,建议使用的过程中诸如rawrepotest1全部一致,这样blob和repository的关系也比较清楚,无非多上传几个大小可以忽略不计的json文件而已。

步骤2: 上传json文件

liumiaocn:~ liumiao$ curl -X POST -u admin:admin123 --header "Content-Type: application/json" http://localhost:32004/service/siesta/rest/v1/script -d @rawrepotest1.json
liumiaocn:~ liumiao$

步骤3: 执行groovy文件

liumiaocn:~ liumiao$ curl -X POST -u admin:admin123 --header "Content-Type: text/plain" http://localhost:32004/service/siesta/rest/v1/script/rawrepotest1/run
{
 "name" : "rawrepotest1",
 "result" : "RepositoryImpl$$EnhancerByGuice$$13e8178d{type=hosted, format=raw, name='rawrepotest1'}"
}liumiaocn:~ liumiao$

结果确认

blob确认

已经生成相应的blob:rawrepotest1

Nexus使用Api进行操作

repository确认

已经生成相应的raw方式的repository:rawrepotest1

Nexus使用Api进行操作

小结

Nexus中结合groovy能够实现Api方式的集成,但是这种方式在使用上还有诸多的不变,多次执行是否出错等都成为groovy脚本确认的事项,相关功能是否会强化可能还需要看nexus后续版本的支持情况,和groovy的结合方式会不会是功能过度时期的对应方式还需进一步观察。

相关推荐