与Maven和Docker的集成测试
Docker是其中的新熱點(diǎn)之一。 與傳統(tǒng)虛擬機(jī)相比，它具有一套不同的技術(shù)和思想，并通過容器的思想實(shí)現(xiàn)了相似但同時(shí)又有所不同的事物：幾乎所有VM都具有強(qiáng)大的功能，但速度更快，并且具有非常有趣的附加功能。
在本文中，我假設(shè)您已經(jīng)對Docker有所了解，并且知道如何與之交互。 如果不是這種情況，我可以建議您從以下鏈接開始：
- http://www.docker.io/gettingstarted
- http://coreos.com/docs/launching-containers/building/getting-started-with-docker/
- http://robknight.org.uk/blog/2013/05/drupal-on-docker/
我對該主題的個(gè)人貢獻(xiàn)是向您展示可能的工作流 ，該工作流允許您從Maven作業(yè)中啟動(dòng)和停止Docker容器。
我研究此功能的原因是為了幫助使用Maven構(gòu)建的Java項(xiàng)目中的測試和集成測試 。 這個(gè)問題是眾所周知的：您的代碼與外部系統(tǒng)和服務(wù)交互。 根據(jù)您實(shí)際編寫的內(nèi)容，這可能意味著數(shù)據(jù)庫，消息代理，Web服務(wù)等。
測試這些交互的常用策略是：
- 在內(nèi)存服務(wù)器中； 用Java實(shí)現(xiàn)，通常很快，但是很多時(shí)候它們的局限性在于它們不是真實(shí)的東西
- 您實(shí)現(xiàn)的存根服務(wù)層，以提供所需的接口。
- 真實(shí)的外部流程 （有時(shí)是遠(yuǎn)程的），用于測試真實(shí)的交互。
這些策略是可行的，但通常需要付出很多努力才能付諸實(shí)踐。 最完整的一種使用適當(dāng)?shù)耐獠糠?wù)，這給隔離帶來了問題：假設(shè)您正在與數(shù)據(jù)庫進(jìn)行交互，并且在其他人訪問相同資源的同時(shí)執(zhí)行讀/寫操作。 同樣，您可能會(huì)找到正確的工作流，這些工作流涉及創(chuàng)建單獨(dú)的模式等等，但是，這又是額外的工作，而且通常不是很簡單的活動(dòng)。
如果我們能擁有與這些外部系統(tǒng)相同的機(jī)會(huì)，但完全孤立的話，那不是很好嗎？ 如果我也增加報(bào)價(jià)，您會(huì)怎么看？
Docker是為我們提供這一機(jī)會(huì)的工具。
在測試套件的開頭，您可以使用所需的所有服務(wù)啟動(dòng)一組Docker容器，并在結(jié)束時(shí)將其拆解。 您的Maven工作可以成為這些服務(wù)的唯一使用者，并且需要所有隔離功能。 您可以在Dockerfile的幫助下輕松編寫所有腳本，最后，它們只不過是一系列順序的命令行調(diào)用。
讓我們看看如何啟用所有這些功能。
顯然，第一個(gè)前提條件是在系統(tǒng)上安裝Docker。 您可能已經(jīng)知道Docker技術(shù)取決于Linux內(nèi)核的功能，所以您必須使用Linux或需要傳統(tǒng)VM的幫助來托管D??ocker服務(wù)器進(jìn)程。
這是官方文檔指南，向您展示如何在不同的Linux發(fā)行版中進(jìn)行安裝： http : //docs.docker.io/en/latest/installation/
相反，這是一個(gè)非常快速的指南，顯示了如何在MacOSX上進(jìn)行安裝： http : //blog.javabien.net/2014/03/03/setup-docker-on-osx-the-no-brainer-way /
準(zhǔn)備就緒并安裝Docker后，需要應(yīng)用特定的配置 。
在最新版本的Docker中，默認(rèn)情況下僅通過Unix套接字公開其遠(yuǎn)程API。 盡管我們可以使用正確的代碼與它們進(jìn)行交互，但我發(fā)現(xiàn)通過HTTP與API進(jìn)行交互要容易得多。 為此，您必須將特定標(biāo)志傳遞給Docker守護(hù)程序，以使其也監(jiān)聽HTTP。
我正在使用Fedora，要修改的配置文件是/usr/lib/systemd/system/docker.service 。
[Unit] Description=Docker Application Container Engine Documentation=http://docs.docker.io After=network.target[Service] ExecStart=/usr/bin/docker -d -H tcp://127.0.0.1:4243 -H unix:///var/run/docker.sock Restart=on-failure[Install] WantedBy=multi-user.target與默認(rèn)值相比，唯一的修改是添加了-H tcp://127.0.0.1:4243 。
現(xiàn)在，在重新加載systemd腳本并重新啟動(dòng)服務(wù)之后，我有了一個(gè)Docker守護(hù)程序，該守護(hù)程序向我展示了一個(gè)不錯(cuò)的REST API ，可以用curl戳一下。
sudo systemctl daemon-reload sudo systemctl restart docker curl http://127.0.0.1:4243/images/json # returns a json in output您可能還希望此配置能夠在將來的Docker rpm更新中保留下來。 為了實(shí)現(xiàn)這一點(diǎn)，您必須將剛剛修改的文件復(fù)制到可以保留rpm更新的位置。 在systemd實(shí)現(xiàn)此目標(biāo)的正確方法是：
sudo cp /usr/lib/systemd/system/docker.service /etc/systemd/system如果您使用的是Ubuntu ，則必須配置其他文件。 查看此頁面： http : //blog.trifork.com/2013/12/24/docker-from-a-distance-the-remote-api/
現(xiàn)在，我們擁有與Docker輕松交互所需的一切。
您可能會(huì)期望我在此向您介紹如何使用Maven Docker插件 。 不幸的是，事實(shí)并非如此。 還沒有這樣的插件 ，或者至少我不知道它。 我正在考慮編寫一個(gè)，但是目前我已經(jīng)借助GMaven插件，一些Groovy代碼和Java庫Rest-assured的幫助快速解決了我的問題。
這是啟動(dòng)Docker容器的代碼
import com.jayway.restassured.RestAssured import static com.jayway.restassured.RestAssured.* import static com.jayway.restassured.matcher.RestAssuredMatchers.* import com.jayway.restassured.path.json.JsonPath import com.jayway.restassured.response.ResponseRestAssured.baseURI = "http://127.0.0.1" RestAssured.port = 4243// here you can specify advance docker params, but the mandatory one is the name of the Image you want to use def dockerImageConf = '{"Image":"${docker.image}"}' def dockerImageName = JsonPath.from(dockerImageConf).get("Image")log.info "Creating new Docker container from image $dockerImageName" def response = with().body(dockerImageConf).post("/containers/create")if( 404 == response.statusCode ) {log.info "Docker image not found in local repo. Trying to dowload image '$dockerImageName' from remote repos"response = with().parameter("fromImage", dockerImageName).post("/images/create")def message = response.asString()//odd: rest api always returns 200 and doesn't return proper json. I have to grepif( message.contains("404") ) fail("Image $dockerImageName NOT FOUND remotely. Abort. $message}")log.info "Image downloaded"// retry to create the containerresponse = with().body(dockerImageConf).post("/containers/create")if( 404 == response.statusCode ) fail("Unable to create container with conf $dockerImageConf: ${response.asString()}") }def containerId = response.jsonPath().get("Id")log.info "Container created with id $containerId"// set the containerId to be retrieved later during the stop phase project.properties.setProperty("containerId", "$containerId")log.info "Starting container $containerId" with().post("/containers/$containerId/start").asString()def ip = with().get("/containers/$containerId/json").path("NetworkSettings.IPAddress")log.info "Container started with ip: $ip" System.setProperty("MONGODB_HOSTNAME", "$ip") System.setProperty("MONGODB_PORT", "27017")這是阻止他們的人
import com.jayway.restassured.RestAssured import static com.jayway.restassured.RestAssured.* import static com.jayway.restassured.matcher.RestAssuredMatchers.*RestAssured.baseURI = "http://127.0.0.1" RestAssured.port = 4243def containerId = project.properties.getProperty('containerId') log.info "Stopping Docker container $containerId" with().post("/containers/$containerId/stop") log.info "Docker container stopped" if( true == ${docker.remove.container} ){with().delete("/containers/$containerId")log.info "Docker container deleted" }放心的流利API應(yīng)該可以提示正在發(fā)生的事情，內(nèi)聯(lián)注釋應(yīng)該可以澄清它，但是讓我添加一些注釋。 啟動(dòng)容器的代碼是我對docker run功能的實(shí)現(xiàn)，如此處的官方API文檔所述： http : //docs.docker.io/en/latest/reference/api/docker_remote_api_v1.9/#inside-docker -跑
我要解決的特定問題是如何將Docker容器的ID從Maven階段傳播到另一個(gè)階段 。 我已經(jīng)實(shí)現(xiàn)了以下功能：
// set the containerId to be retrieved later during the stop phase project.properties.setProperty("containerId", "$containerId")我還公開了一些Maven屬性，可用于與API交互：
- docker.image –您要旋轉(zhuǎn)的圖像的名稱
- docker.remove.container –如果設(shè)置為false，則告訴Maven不要從文件系統(tǒng)中刪除已停止的容器（在作業(yè)完成后用于檢查Docker容器）
例如
mvn verify -Ddocker.image=pantinor/fuse -Ddocker.remove.container=false您可以在此處找到完整的工作示例。 有人告訴我，有時(shí)我的語法著色器腳本會(huì)吃一些關(guān)鍵字或更改單詞的大小寫，因此，如果要復(fù)制和粘貼，可能是從Github裁剪的一個(gè)更好的主意。
這是使用命令mvn verify運(yùn)行Maven構(gòu)建時(shí)輸出的一部分：
... [INFO] --- gmaven-plugin:1.4:execute (start-docker-images) @ gmaven-docker --- [INFO] Creating new Docker container from image {"Image":"pantinor/centos-mongodb"} log4j:WARN No appenders could be found for logger (org.apache.http.impl.conn.BasicClientConnectionManager). log4j:WARN Please initialize the log4j system properly. [INFO] Container created with id 5283d970dc16bd7d64ec08744b5ecec09b57d9a81162826e847666b8fb421dbc [INFO] Starting container 5283d970dc16bd7d64ec08744b5ecec09b57d9a81162826e847666b8fb421dbc [INFO] Container started with ip: 172.17.0.2...[INFO] --- gmaven-plugin:1.4:execute (stop-docker-images) @ gmaven-docker --- [INFO] Stopping Docker container 5283d970dc16bd7d64ec08744b5ecec09b57d9a81162826e847666b8fb421dbc [INFO] Docker container stopped [INFO] Docker container deleted...如果您有任何疑問或建議，請隨時(shí)告訴我！
完整的Maven`pom.xml`也可以在這里找到： https ://raw.githubusercontent.com/paoloantinori/gmaven_docker/master/pom.xml
<!--?xml version="1.0"?--> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemalocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelversion>4.0.0</modelversion><artifactid>gmaven-docker</artifactid><groupid>paolo.test</groupid><version>1.0.0-SNAPSHOT</version><name>Sample Maven Docker integration</name><description>See companion blogpost here: </description><build><plugins><plugin><groupid>org.codehaus.gmaven</groupid><artifactid>gmaven-plugin</artifactid><version>1.4</version><configuration><providerselection>2.0</providerselection></configuration><executions><execution><id>start-docker-images</id><phase>test</phase><goals><goal>execute</goal></goals><configuration><source><!--[CDATA[ import com.jayway.restassured.RestAssured import static com.jayway.restassured.RestAssured.* import static com.jayway.restassured.matcher.RestAssuredMatchers.*RestAssured.baseURI = "http://127.0.0.1" RestAssured.port = 4243// here you can specify advance docker params, but the mandatory one is the name of the Image you want to use def dockerImage = '{"Image":"pantinor/centos-mongodb"}'log.info "Creating new Docker container from image $dockerImage" def response = with().body(dockerImage).post("/containers/create")if( 404 == response.statusCode ) {log.info "[INFO] Docker Image not found. Downloading from Docker Registry"log.info with().parameter("fromImage", "pantinor/centos-mongodb").post("/images/create").asString()log.info "Image downloaded" }// retry to create the container def containerId = with().body(dockerImage).post("/containers/create").path("Id")log.info "Container created with id $containerId"// set the containerId to be retrieved later during the stop phase project.properties.setProperty("containerId", "$containerId")log.info "Starting container $containerId" with().post("/containers/$containerId/start").asString()def ip = with().get("/containers/$containerId/json").path("NetworkSettings.IPAddress")log.info "Container started with ip: $ip"System.setProperty("MONGODB_HOSTNAME", "$ip") System.setProperty("MONGODB_PORT", "27017") ]]--></configuration></execution><execution><id>stop-docker-images</id><phase>post-integration-test</phase><goals><goal>execute</goal></goals><configuration><source><!--[CDATA[ import com.jayway.restassured.RestAssured import static com.jayway.restassured.RestAssured.* import static com.jayway.restassured.matcher.RestAssuredMatchers.*RestAssured.baseURI = "http://127.0.0.1" RestAssured.port = 4243def containerId = project.properties.getProperty('containerId') log.info "Stopping Docker container $containerId" with().post("/containers/$containerId/stop") log.info "Docker container stopped" with().delete("/containers/$containerId") log.info "Docker container deleted" ]]--></configuration></execution></executions></plugin></plugins></build><dependencies><dependency><groupid>com.jayway.restassured</groupid><artifactid>rest-assured</artifactid><version>1.8.1</version><scope>test</scope></dependency></dependencies> </project> 參考：在Someday Never Comes博客上，我們的JCG合作伙伴 Paolo Antinori 與Maven和Docker進(jìn)行了集成測試 。翻譯自: https://www.javacodegeeks.com/2014/03/integration-testing-with-maven-and-docker.html
總結(jié)
以上是生活随笔為你收集整理的与Maven和Docker的集成测试的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： 牛排有八分熟吗 牛排分几成熟
- 下一篇： 为JVM分配内存：一个案例研究