From df7d82fdcc526382fe0f035399af6fa771d17021 Mon Sep 17 00:00:00 2001 From: yyfcc17 Date: Tue, 31 Jul 2018 01:46:47 +0800 Subject: [PATCH 01/11] add documents for issue #22, Group 5 --- ...12\346\211\213\346\214\207\345\215\227.md" | 108 ++++++++++++++++++ ...perience environment setup and Handbook.md | 103 +++++++++++++++++ 2 files changed, 211 insertions(+) create mode 100644 "blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" create mode 100644 blog-en/VirtualBox Ubuntu16.04 based PouchContainer experience environment setup and Handbook.md diff --git "a/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" "b/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" new file mode 100644 index 0000000..399b392 --- /dev/null +++ "b/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" @@ -0,0 +1,108 @@ +# 介绍 +PouchContainer 是高效的、轻量级企业级容器引擎技术，拥有隔离性强、可移植性高、资源占用少等特性。它目前仅支持Linux操作系统，故需要使用虚拟机进行本地运行和测试。本篇指南将指导读者在Mac或Windows上搭建基于VirtualBox + Ubuntu16.04的PouchContainer环境。 + +# VirtualBox的安装 +__1、可以从以下方式中选择其一进行安装：__ +* 阿里郎-管家-办公软件管理中搜索VirtualBox，下载并安装。 +* 从 [https://download.virtualbox.org/virtualbox/5.2.16/VirtualBox-5.2.16-123759-OSX.dmg](https://download.virtualbox.org/virtualbox/5.2.16/VirtualBox-5.2.16-123759-OSX.dmg) 下载安装包，下载并安装 +__2、下载完成后，双击VirtualBox.pkg，然后点击“继续”进入安装__ + + +![image.png | left | 506x337](https://cdn.nlark.com/lark/0/2018/png/135654/1532951526444-e74b8693-7e36-40f9-b1da-84d4658d0389.png "") + +__3、自定义安装__ + + +![image.png | left | 502x334](https://cdn.nlark.com/lark/0/2018/png/135654/1532951637319-dd1a8547-4c4c-4db1-91cd-4fb9ec386d93.png "") + +
+
+
+ +# VirtualBox的配置 +1、__打开VirtualBox，选择"新建"，新建虚拟机__ + +![image.png | left | 236x61](https://cdn.nlark.com/lark/0/2018/png/124199/1532951984471-9dc5e69b-04d6-4ca3-acfe-cb33341445c4.png "") + +__2、设置新建虚拟电脑的名称和系统类型__ +* 名称-自定义 +* 类型-Linux +* 版本-Ubuntu（64-bit） + + +![image.png | left | 498x449](https://cdn.nlark.com/lark/0/2018/png/124199/1532952147747-22a62b89-a974-4e25-a835-1327ba455f78.png "") + +__3、设置内存大小，可以选择默认大小（1024MB）,点击“继续”__ + +![image.png | left | 497x438](https://cdn.nlark.com/lark/0/2018/png/124199/1532952488126-781dcfd5-521e-46cb-88b0-fe55ddc6c2de.png "") +__4、虚拟硬盘选择：__ +* 选择“使用已有的虚拟硬盘文件”，点击选择文件（选择ubuntuPouch.vdi，此Ubuntu已经安装好了PouchContainer），点击“创建”。 +* 如果没有这样的文件。点击“现在创建虚拟硬盘”，自行配置系统并手动[安装PouchContainer](https://github.com/alibaba/pouch/blob/master/INSTALLATION.md)。 + + +![image.png | left | 493x430](https://cdn.nlark.com/lark/0/2018/png/124199/1532965407472-70a22b38-dfbb-4598-97ce-f2188ad7bd5d.png "") + +# 启动虚拟机并登录pouch +__1、点击“启动”，输入初始的用户名和密码__ +```plain +用户名：pouch +密 码：123456 +``` +__2、切换到root权限__ +```plain +sudo -i +``` +__3、检查网络：__ +```html +ping www.alibaba-inc.com +``` +__4、启动pouch服务（默认开机启动）:__ +``` +systemctl start pouch //如果有问题，请确认网络连接正确 +``` +__5、启动一个已经存在的busybox基础容器：__ +``` +pouch run -t -d busybox sh +``` +__6、如果您没有busybox，可以pull：__ +``` +pouch pull busybox +``` +__7、登录到启动的容器中，其中{ID}是启动命令输出的完整ID中的前六位：__ +``` +pouch exec -it {ID} sh +``` + +操作成功后如图所示： +[ + +![image.png | left | 747x113](https://camo.githubusercontent.com/91f9a4433d2cdbf34b4f3469d4e80c2bd21cfa0a/68747470733a2f2f63646e2e6e6c61726b2e636f6d2f6c61726b2f302f323031382f706e672f3132313937312f313533323335323136373137312d33313637633962362d396234392d343639382d623035362d6532363037336536343331322e706e67 "") +](https://camo.githubusercontent.com/91f9a4433d2cdbf34b4f3469d4e80c2bd21cfa0a/68747470733a2f2f63646e2e6e6c61726b2e636f6d2f6c61726b2f302f323031382f706e672f3132313937312f313533323335323136373137312d33313637633962362d396234392d343639382d623035362d6532363037336536343331322e706e67) + +# Mac终端连接到virtualbox虚拟机 +使用virtualbox创建虚拟机进行工作，可以有效减少本机环境与工作环境之间的相互影响。但由于Server虚拟机的界面不友好，因而使用SSH连接到虚拟机，使用本地终端编辑是一个非常好的选择。 +__1、端口转发__ +点击“设置”-“网络”-“高级”-“端口转发” + + +![image.png | left | 558x389](https://cdn.nlark.com/lark/0/2018/png/135654/1532955458851-bc1c46ed-1ad9-4714-8d4c-1a2deb83f5ec.png "") + + +点击红框中的icon，设置主机端口9022，子系统端口22，保存。 + + +![image.png | left | 550x397](https://cdn.nlark.com/lark/0/2018/png/135654/1532955772003-e4dba259-6dae-46bf-96a8-bc9c38f10115.png "") + +__2、本机终端连接__ +在终端输入 +```plain +$ ssh -p 9022 username@127.0.0.1 +或$ ssh -p 9022 username@localhost +``` +连接成功效果如图所示： + + +![image.png | left | 747x352](https://cdn.nlark.com/lark/0/2018/png/135654/1532956235912-f6789f20-c0e8-4758-8f5e-a76fea5b61b7.png "") + +至此，您已完成环境搭建，并且可以用终端操作，尽情享受PouchContainer吧！ + diff --git a/blog-en/VirtualBox Ubuntu16.04 based PouchContainer experience environment setup and Handbook.md b/blog-en/VirtualBox Ubuntu16.04 based PouchContainer experience environment setup and Handbook.md new file mode 100644 index 0000000..58e58c9 --- /dev/null +++ b/blog-en/VirtualBox Ubuntu16.04 based PouchContainer experience environment setup and Handbook.md @@ -0,0 +1,103 @@ +# Introduction +PouchContainer is a high-efficiency and enterprise-class container engine with the characteristics of strong isolation, high portability and low resource consumption. Currently, PouchContainer only supports the Linux operating system, so a virtual machine is required to run and test locally. This guide instructs the readers to build a PouchContainer environment based on VirtualBox + Ubuntu 16.04 on Mac or Windows. + + +# Installing VirtualBox +__1. You can choose one of the following ways to install Virtualbox:__ +* Search virtualbox from AliLlang (Manager->Software download) , download it, then install +* Download virtualbox from [VirtualBox](https://download.virtualbox.org/virtualbox/5.2.16/VirtualBox-5.2.16-123759-OSX.dmg), then install +2. After finished, double-click VirtualBox.pkg and click Continue to install. + + + +![image.png | left | 564x376](https://cdn.nlark.com/lark/0/2018/png/135654/1532965787724-f8873d75-0db0-44ae-9e76-38e463193304.png "") + +__3.Customizable installation is available__ + + +![image.png | left | 556x370](https://cdn.nlark.com/lark/0/2018/png/135654/1532965968099-0b8e72cc-fe70-452a-a5db-2a8c4fd63d63.png "") + + +# Configuring VirtualBox +1、Open VirtualBox，Click New in the VirtualBox Manager to create a new virtual machine + + +![image.png | left | 265x68](https://cdn.nlark.com/lark/0/2018/png/135654/1532966022381-d6c1f736-be1e-4a84-93ca-f14f33a85d75.png "") + +__2、Input the name, systemm type and version of the new virtual machine.__ +* Choosing a desired name +* Linux type +* Ubuntu (64-bit) version + + +![image.png | left | 538x485](https://cdn.nlark.com/lark/0/2018/png/135654/1532966206015-a825b620-aff5-49b2-b630-9a7302333a8a.png "") + +3、Set the memory size of the virtual machine, or choosing the default size(1024 MB). Then click Next. + + +![image.png | left | 551x485](https://cdn.nlark.com/lark/0/2018/png/135654/1532966237848-4134d823-745d-46ca-bc7b-bb91a029c478.png "") + +4、Virtual hard disk settings +* Choose Using the existing virtual hard disk file, click to choose the file (choose ubuntuPouch.vdi, this Ubuntu has been installed PouchContainer). +* If there is no such a file, click create the virtual hard disk now, and you can configure the system itself and manually install the PouchContainer. Then click create. + + +![image.png | left | 564x492](https://cdn.nlark.com/lark/0/2018/png/135654/1532966506742-18f40273-a294-47cd-b799-bcaf115579d3.png "") + +# Enter the virtual machine, start and log in the pouch. +1、Click start, input the original username and password +``` +username：pouch +password：123456 +``` +__2、Switch to the root user__ +``` +sudo -i +``` +__3、Check network connection__ +``` +ping www.alibaba-inc.com +``` +__4、Start the pouch service (default boot) __ +``` +systemctl start pouch //If not succeed, check the network again +``` +__5、Start an existing busybox base container__ +``` +pouch run -t -d busybox sh +``` +__6、Do pull if no busybox available__ +``` +pouch pull busybox +``` +__7、Log in the started container, the ID is the first 6 digits of the complete IDs from the previous __ +``` +pouch exec -it {ID} sh +``` +command output + + +![image.png | left | 747x113](https://cdn.nlark.com/lark/0/2018/png/135654/1532967272649-b1548c1e-bd10-4487-8dc1-64773bf929fe.png "") + +# Connecting Mac terminal with Virtualbox +Using a virtual machine created by Virtualbox while working can effectively reduce potential interference between the local environment and the working environment. However, the UI of Server is not friendly. Using SSH to connect to virtual machine and local terminals to edit is a suggesting alternative. +__1、Port forwarding__ +1) Click *Setting*, *Internet, Advanced and Port forwarding* + + +![image.png | left | 568x395](https://cdn.nlark.com/lark/0/2018/png/135654/1532967358783-7cb8dc18-6b20-47bd-9fdb-1a2f60d531dc.png "") + +2)Click the icon in red, and set host post *9022， *subsystem port *22*. Then save. + + +![image.png | left | 544x393](https://cdn.nlark.com/lark/0/2018/png/135654/1532967432115-464b2478-dd49-4aa8-ba66-21cca6c1c8fd.png "") + +3)Local terminal connection + +A successful connection interface will be + + +![image.png | left | 614x289](https://cdn.nlark.com/lark/0/2018/png/135654/1532967488069-5a46f6aa-b9c0-4a98-9cb8-feaceaa4c53c.png "") + +Until now, you have finished the environment construction and you can operate on the terminal. Please enjoy your journey on PouchContainer! + From e2ff54ad21e655a637c7441e672d67dca78ca0ef Mon Sep 17 00:00:00 2001 From: yyfcc17 Date: Tue, 31 Jul 2018 01:51:05 +0800 Subject: [PATCH 02/11] Revert "add documents for issue #22, Group 5" This reverts commit df7d82fdcc526382fe0f035399af6fa771d17021. --- ...12\346\211\213\346\214\207\345\215\227.md" | 108 ------------------ ...perience environment setup and Handbook.md | 103 ----------------- 2 files changed, 211 deletions(-) delete mode 100644 "blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" delete mode 100644 blog-en/VirtualBox Ubuntu16.04 based PouchContainer experience environment setup and Handbook.md diff --git "a/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" "b/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" deleted file mode 100644 index 399b392..0000000 --- "a/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" +++ /dev/null @@ -1,108 +0,0 @@ -# 介绍 -PouchContainer 是高效的、轻量级企业级容器引擎技术，拥有隔离性强、可移植性高、资源占用少等特性。它目前仅支持Linux操作系统，故需要使用虚拟机进行本地运行和测试。本篇指南将指导读者在Mac或Windows上搭建基于VirtualBox + Ubuntu16.04的PouchContainer环境。 - -# VirtualBox的安装 -__1、可以从以下方式中选择其一进行安装：__ -* 阿里郎-管家-办公软件管理中搜索VirtualBox，下载并安装。 -* 从 [https://download.virtualbox.org/virtualbox/5.2.16/VirtualBox-5.2.16-123759-OSX.dmg](https://download.virtualbox.org/virtualbox/5.2.16/VirtualBox-5.2.16-123759-OSX.dmg) 下载安装包，下载并安装 -__2、下载完成后，双击VirtualBox.pkg，然后点击“继续”进入安装__ - - -![image.png | left | 506x337](https://cdn.nlark.com/lark/0/2018/png/135654/1532951526444-e74b8693-7e36-40f9-b1da-84d4658d0389.png "") - -__3、自定义安装__ - - -![image.png | left | 502x334](https://cdn.nlark.com/lark/0/2018/png/135654/1532951637319-dd1a8547-4c4c-4db1-91cd-4fb9ec386d93.png "") - -
-
-
- -# VirtualBox的配置 -1、__打开VirtualBox，选择"新建"，新建虚拟机__ - -![image.png | left | 236x61](https://cdn.nlark.com/lark/0/2018/png/124199/1532951984471-9dc5e69b-04d6-4ca3-acfe-cb33341445c4.png "") - -__2、设置新建虚拟电脑的名称和系统类型__ -* 名称-自定义 -* 类型-Linux -* 版本-Ubuntu（64-bit） - - -![image.png | left | 498x449](https://cdn.nlark.com/lark/0/2018/png/124199/1532952147747-22a62b89-a974-4e25-a835-1327ba455f78.png "") - -__3、设置内存大小，可以选择默认大小（1024MB）,点击“继续”__ - -![image.png | left | 497x438](https://cdn.nlark.com/lark/0/2018/png/124199/1532952488126-781dcfd5-521e-46cb-88b0-fe55ddc6c2de.png "") -__4、虚拟硬盘选择：__ -* 选择“使用已有的虚拟硬盘文件”，点击选择文件（选择ubuntuPouch.vdi，此Ubuntu已经安装好了PouchContainer），点击“创建”。 -* 如果没有这样的文件。点击“现在创建虚拟硬盘”，自行配置系统并手动[安装PouchContainer](https://github.com/alibaba/pouch/blob/master/INSTALLATION.md)。 - - -![image.png | left | 493x430](https://cdn.nlark.com/lark/0/2018/png/124199/1532965407472-70a22b38-dfbb-4598-97ce-f2188ad7bd5d.png "") - -# 启动虚拟机并登录pouch -__1、点击“启动”，输入初始的用户名和密码__ -```plain -用户名：pouch -密 码：123456 -``` -__2、切换到root权限__ -```plain -sudo -i -``` -__3、检查网络：__ -```html -ping www.alibaba-inc.com -``` -__4、启动pouch服务（默认开机启动）:__ -``` -systemctl start pouch //如果有问题，请确认网络连接正确 -``` -__5、启动一个已经存在的busybox基础容器：__ -``` -pouch run -t -d busybox sh -``` -__6、如果您没有busybox，可以pull：__ -``` -pouch pull busybox -``` -__7、登录到启动的容器中，其中{ID}是启动命令输出的完整ID中的前六位：__ -``` -pouch exec -it {ID} sh -``` - -操作成功后如图所示： -[ - -![image.png | left | 747x113](https://camo.githubusercontent.com/91f9a4433d2cdbf34b4f3469d4e80c2bd21cfa0a/68747470733a2f2f63646e2e6e6c61726b2e636f6d2f6c61726b2f302f323031382f706e672f3132313937312f313533323335323136373137312d33313637633962362d396234392d343639382d623035362d6532363037336536343331322e706e67 "") -](https://camo.githubusercontent.com/91f9a4433d2cdbf34b4f3469d4e80c2bd21cfa0a/68747470733a2f2f63646e2e6e6c61726b2e636f6d2f6c61726b2f302f323031382f706e672f3132313937312f313533323335323136373137312d33313637633962362d396234392d343639382d623035362d6532363037336536343331322e706e67) - -# Mac终端连接到virtualbox虚拟机 -使用virtualbox创建虚拟机进行工作，可以有效减少本机环境与工作环境之间的相互影响。但由于Server虚拟机的界面不友好，因而使用SSH连接到虚拟机，使用本地终端编辑是一个非常好的选择。 -__1、端口转发__ -点击“设置”-“网络”-“高级”-“端口转发” - - -![image.png | left | 558x389](https://cdn.nlark.com/lark/0/2018/png/135654/1532955458851-bc1c46ed-1ad9-4714-8d4c-1a2deb83f5ec.png "") - - -点击红框中的icon，设置主机端口9022，子系统端口22，保存。 - - -![image.png | left | 550x397](https://cdn.nlark.com/lark/0/2018/png/135654/1532955772003-e4dba259-6dae-46bf-96a8-bc9c38f10115.png "") - -__2、本机终端连接__ -在终端输入 -```plain -$ ssh -p 9022 username@127.0.0.1 -或$ ssh -p 9022 username@localhost -``` -连接成功效果如图所示： - - -![image.png | left | 747x352](https://cdn.nlark.com/lark/0/2018/png/135654/1532956235912-f6789f20-c0e8-4758-8f5e-a76fea5b61b7.png "") - -至此，您已完成环境搭建，并且可以用终端操作，尽情享受PouchContainer吧！ - diff --git a/blog-en/VirtualBox Ubuntu16.04 based PouchContainer experience environment setup and Handbook.md b/blog-en/VirtualBox Ubuntu16.04 based PouchContainer experience environment setup and Handbook.md deleted file mode 100644 index 58e58c9..0000000 --- a/blog-en/VirtualBox Ubuntu16.04 based PouchContainer experience environment setup and Handbook.md +++ /dev/null @@ -1,103 +0,0 @@ -# Introduction -PouchContainer is a high-efficiency and enterprise-class container engine with the characteristics of strong isolation, high portability and low resource consumption. Currently, PouchContainer only supports the Linux operating system, so a virtual machine is required to run and test locally. This guide instructs the readers to build a PouchContainer environment based on VirtualBox + Ubuntu 16.04 on Mac or Windows. - - -# Installing VirtualBox -__1. You can choose one of the following ways to install Virtualbox:__ -* Search virtualbox from AliLlang (Manager->Software download) , download it, then install -* Download virtualbox from [VirtualBox](https://download.virtualbox.org/virtualbox/5.2.16/VirtualBox-5.2.16-123759-OSX.dmg), then install -2. After finished, double-click VirtualBox.pkg and click Continue to install. - - - -![image.png | left | 564x376](https://cdn.nlark.com/lark/0/2018/png/135654/1532965787724-f8873d75-0db0-44ae-9e76-38e463193304.png "") - -__3.Customizable installation is available__ - - -![image.png | left | 556x370](https://cdn.nlark.com/lark/0/2018/png/135654/1532965968099-0b8e72cc-fe70-452a-a5db-2a8c4fd63d63.png "") - - -# Configuring VirtualBox -1、Open VirtualBox，Click New in the VirtualBox Manager to create a new virtual machine - - -![image.png | left | 265x68](https://cdn.nlark.com/lark/0/2018/png/135654/1532966022381-d6c1f736-be1e-4a84-93ca-f14f33a85d75.png "") - -__2、Input the name, systemm type and version of the new virtual machine.__ -* Choosing a desired name -* Linux type -* Ubuntu (64-bit) version - - -![image.png | left | 538x485](https://cdn.nlark.com/lark/0/2018/png/135654/1532966206015-a825b620-aff5-49b2-b630-9a7302333a8a.png "") - -3、Set the memory size of the virtual machine, or choosing the default size(1024 MB). Then click Next. - - -![image.png | left | 551x485](https://cdn.nlark.com/lark/0/2018/png/135654/1532966237848-4134d823-745d-46ca-bc7b-bb91a029c478.png "") - -4、Virtual hard disk settings -* Choose Using the existing virtual hard disk file, click to choose the file (choose ubuntuPouch.vdi, this Ubuntu has been installed PouchContainer). -* If there is no such a file, click create the virtual hard disk now, and you can configure the system itself and manually install the PouchContainer. Then click create. - - -![image.png | left | 564x492](https://cdn.nlark.com/lark/0/2018/png/135654/1532966506742-18f40273-a294-47cd-b799-bcaf115579d3.png "") - -# Enter the virtual machine, start and log in the pouch. -1、Click start, input the original username and password -``` -username：pouch -password：123456 -``` -__2、Switch to the root user__ -``` -sudo -i -``` -__3、Check network connection__ -``` -ping www.alibaba-inc.com -``` -__4、Start the pouch service (default boot) __ -``` -systemctl start pouch //If not succeed, check the network again -``` -__5、Start an existing busybox base container__ -``` -pouch run -t -d busybox sh -``` -__6、Do pull if no busybox available__ -``` -pouch pull busybox -``` -__7、Log in the started container, the ID is the first 6 digits of the complete IDs from the previous __ -``` -pouch exec -it {ID} sh -``` -command output - - -![image.png | left | 747x113](https://cdn.nlark.com/lark/0/2018/png/135654/1532967272649-b1548c1e-bd10-4487-8dc1-64773bf929fe.png "") - -# Connecting Mac terminal with Virtualbox -Using a virtual machine created by Virtualbox while working can effectively reduce potential interference between the local environment and the working environment. However, the UI of Server is not friendly. Using SSH to connect to virtual machine and local terminals to edit is a suggesting alternative. -__1、Port forwarding__ -1) Click *Setting*, *Internet, Advanced and Port forwarding* - - -![image.png | left | 568x395](https://cdn.nlark.com/lark/0/2018/png/135654/1532967358783-7cb8dc18-6b20-47bd-9fdb-1a2f60d531dc.png "") - -2)Click the icon in red, and set host post *9022， *subsystem port *22*. Then save. - - -![image.png | left | 544x393](https://cdn.nlark.com/lark/0/2018/png/135654/1532967432115-464b2478-dd49-4aa8-ba66-21cca6c1c8fd.png "") - -3)Local terminal connection - -A successful connection interface will be - - -![image.png | left | 614x289](https://cdn.nlark.com/lark/0/2018/png/135654/1532967488069-5a46f6aa-b9c0-4a98-9cb8-feaceaa4c53c.png "") - -Until now, you have finished the environment construction and you can operate on the terminal. Please enjoy your journey on PouchContainer! - From 1cab7c879d5bf91cba5ae6e90cebbba6ba41303d Mon Sep 17 00:00:00 2001 From: yyfcc17 Date: Tue, 31 Jul 2018 01:54:24 +0800 Subject: [PATCH 03/11] Add documents for #22, Group 5 --- ...nt based on VirtualBox and Ubuntu 16.04.md | 103 ++++++++++++++++++ 1 file changed, 103 insertions(+) create mode 100644 blog-en/Building a PouchContainer environment based on VirtualBox and Ubuntu 16.04.md diff --git a/blog-en/Building a PouchContainer environment based on VirtualBox and Ubuntu 16.04.md b/blog-en/Building a PouchContainer environment based on VirtualBox and Ubuntu 16.04.md new file mode 100644 index 0000000..58e58c9 --- /dev/null +++ b/blog-en/Building a PouchContainer environment based on VirtualBox and Ubuntu 16.04.md @@ -0,0 +1,103 @@ +# Introduction +PouchContainer is a high-efficiency and enterprise-class container engine with the characteristics of strong isolation, high portability and low resource consumption. Currently, PouchContainer only supports the Linux operating system, so a virtual machine is required to run and test locally. This guide instructs the readers to build a PouchContainer environment based on VirtualBox + Ubuntu 16.04 on Mac or Windows. + + +# Installing VirtualBox +__1. You can choose one of the following ways to install Virtualbox:__ +* Search virtualbox from AliLlang (Manager->Software download) , download it, then install +* Download virtualbox from [VirtualBox](https://download.virtualbox.org/virtualbox/5.2.16/VirtualBox-5.2.16-123759-OSX.dmg), then install +2. After finished, double-click VirtualBox.pkg and click Continue to install. + + + +![image.png | left | 564x376](https://cdn.nlark.com/lark/0/2018/png/135654/1532965787724-f8873d75-0db0-44ae-9e76-38e463193304.png "") + +__3.Customizable installation is available__ + + +![image.png | left | 556x370](https://cdn.nlark.com/lark/0/2018/png/135654/1532965968099-0b8e72cc-fe70-452a-a5db-2a8c4fd63d63.png "") + + +# Configuring VirtualBox +1、Open VirtualBox，Click New in the VirtualBox Manager to create a new virtual machine + + +![image.png | left | 265x68](https://cdn.nlark.com/lark/0/2018/png/135654/1532966022381-d6c1f736-be1e-4a84-93ca-f14f33a85d75.png "") + +__2、Input the name, systemm type and version of the new virtual machine.__ +* Choosing a desired name +* Linux type +* Ubuntu (64-bit) version + + +![image.png | left | 538x485](https://cdn.nlark.com/lark/0/2018/png/135654/1532966206015-a825b620-aff5-49b2-b630-9a7302333a8a.png "") + +3、Set the memory size of the virtual machine, or choosing the default size(1024 MB). Then click Next. + + +![image.png | left | 551x485](https://cdn.nlark.com/lark/0/2018/png/135654/1532966237848-4134d823-745d-46ca-bc7b-bb91a029c478.png "") + +4、Virtual hard disk settings +* Choose Using the existing virtual hard disk file, click to choose the file (choose ubuntuPouch.vdi, this Ubuntu has been installed PouchContainer). +* If there is no such a file, click create the virtual hard disk now, and you can configure the system itself and manually install the PouchContainer. Then click create. + + +![image.png | left | 564x492](https://cdn.nlark.com/lark/0/2018/png/135654/1532966506742-18f40273-a294-47cd-b799-bcaf115579d3.png "") + +# Enter the virtual machine, start and log in the pouch. +1、Click start, input the original username and password +``` +username：pouch +password：123456 +``` +__2、Switch to the root user__ +``` +sudo -i +``` +__3、Check network connection__ +``` +ping www.alibaba-inc.com +``` +__4、Start the pouch service (default boot) __ +``` +systemctl start pouch //If not succeed, check the network again +``` +__5、Start an existing busybox base container__ +``` +pouch run -t -d busybox sh +``` +__6、Do pull if no busybox available__ +``` +pouch pull busybox +``` +__7、Log in the started container, the ID is the first 6 digits of the complete IDs from the previous __ +``` +pouch exec -it {ID} sh +``` +command output + + +![image.png | left | 747x113](https://cdn.nlark.com/lark/0/2018/png/135654/1532967272649-b1548c1e-bd10-4487-8dc1-64773bf929fe.png "") + +# Connecting Mac terminal with Virtualbox +Using a virtual machine created by Virtualbox while working can effectively reduce potential interference between the local environment and the working environment. However, the UI of Server is not friendly. Using SSH to connect to virtual machine and local terminals to edit is a suggesting alternative. +__1、Port forwarding__ +1) Click *Setting*, *Internet, Advanced and Port forwarding* + + +![image.png | left | 568x395](https://cdn.nlark.com/lark/0/2018/png/135654/1532967358783-7cb8dc18-6b20-47bd-9fdb-1a2f60d531dc.png "") + +2)Click the icon in red, and set host post *9022， *subsystem port *22*. Then save. + + +![image.png | left | 544x393](https://cdn.nlark.com/lark/0/2018/png/135654/1532967432115-464b2478-dd49-4aa8-ba66-21cca6c1c8fd.png "") + +3)Local terminal connection + +A successful connection interface will be + + +![image.png | left | 614x289](https://cdn.nlark.com/lark/0/2018/png/135654/1532967488069-5a46f6aa-b9c0-4a98-9cb8-feaceaa4c53c.png "") + +Until now, you have finished the environment construction and you can operate on the terminal. Please enjoy your journey on PouchContainer! + From 64646bb15fd6c67ad0c467dadd5578de6aebefde Mon Sep 17 00:00:00 2001 From: yyfcc17 Date: Tue, 31 Jul 2018 02:02:25 +0800 Subject: [PATCH 04/11] Add documents for #22, Group 5 --- ...12\346\211\213\346\214\207\345\215\227.md" | 108 ++++++++++++++++++ 1 file changed, 108 insertions(+) create mode 100644 "blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" diff --git "a/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" "b/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" new file mode 100644 index 0000000..399b392 --- /dev/null +++ "b/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" @@ -0,0 +1,108 @@ +# 介绍 +PouchContainer 是高效的、轻量级企业级容器引擎技术，拥有隔离性强、可移植性高、资源占用少等特性。它目前仅支持Linux操作系统，故需要使用虚拟机进行本地运行和测试。本篇指南将指导读者在Mac或Windows上搭建基于VirtualBox + Ubuntu16.04的PouchContainer环境。 + +# VirtualBox的安装 +__1、可以从以下方式中选择其一进行安装：__ +* 阿里郎-管家-办公软件管理中搜索VirtualBox，下载并安装。 +* 从 [https://download.virtualbox.org/virtualbox/5.2.16/VirtualBox-5.2.16-123759-OSX.dmg](https://download.virtualbox.org/virtualbox/5.2.16/VirtualBox-5.2.16-123759-OSX.dmg) 下载安装包，下载并安装 +__2、下载完成后，双击VirtualBox.pkg，然后点击“继续”进入安装__ + + +![image.png | left | 506x337](https://cdn.nlark.com/lark/0/2018/png/135654/1532951526444-e74b8693-7e36-40f9-b1da-84d4658d0389.png "") + +__3、自定义安装__ + + +![image.png | left | 502x334](https://cdn.nlark.com/lark/0/2018/png/135654/1532951637319-dd1a8547-4c4c-4db1-91cd-4fb9ec386d93.png "") + +
+
+
+ +# VirtualBox的配置 +1、__打开VirtualBox，选择"新建"，新建虚拟机__ + +![image.png | left | 236x61](https://cdn.nlark.com/lark/0/2018/png/124199/1532951984471-9dc5e69b-04d6-4ca3-acfe-cb33341445c4.png "") + +__2、设置新建虚拟电脑的名称和系统类型__ +* 名称-自定义 +* 类型-Linux +* 版本-Ubuntu（64-bit） + + +![image.png | left | 498x449](https://cdn.nlark.com/lark/0/2018/png/124199/1532952147747-22a62b89-a974-4e25-a835-1327ba455f78.png "") + +__3、设置内存大小，可以选择默认大小（1024MB）,点击“继续”__ + +![image.png | left | 497x438](https://cdn.nlark.com/lark/0/2018/png/124199/1532952488126-781dcfd5-521e-46cb-88b0-fe55ddc6c2de.png "") +__4、虚拟硬盘选择：__ +* 选择“使用已有的虚拟硬盘文件”，点击选择文件（选择ubuntuPouch.vdi，此Ubuntu已经安装好了PouchContainer），点击“创建”。 +* 如果没有这样的文件。点击“现在创建虚拟硬盘”，自行配置系统并手动[安装PouchContainer](https://github.com/alibaba/pouch/blob/master/INSTALLATION.md)。 + + +![image.png | left | 493x430](https://cdn.nlark.com/lark/0/2018/png/124199/1532965407472-70a22b38-dfbb-4598-97ce-f2188ad7bd5d.png "") + +# 启动虚拟机并登录pouch +__1、点击“启动”，输入初始的用户名和密码__ +```plain +用户名：pouch +密 码：123456 +``` +__2、切换到root权限__ +```plain +sudo -i +``` +__3、检查网络：__ +```html +ping www.alibaba-inc.com +``` +__4、启动pouch服务（默认开机启动）:__ +``` +systemctl start pouch //如果有问题，请确认网络连接正确 +``` +__5、启动一个已经存在的busybox基础容器：__ +``` +pouch run -t -d busybox sh +``` +__6、如果您没有busybox，可以pull：__ +``` +pouch pull busybox +``` +__7、登录到启动的容器中，其中{ID}是启动命令输出的完整ID中的前六位：__ +``` +pouch exec -it {ID} sh +``` + +操作成功后如图所示： +[ + +![image.png | left | 747x113](https://camo.githubusercontent.com/91f9a4433d2cdbf34b4f3469d4e80c2bd21cfa0a/68747470733a2f2f63646e2e6e6c61726b2e636f6d2f6c61726b2f302f323031382f706e672f3132313937312f313533323335323136373137312d33313637633962362d396234392d343639382d623035362d6532363037336536343331322e706e67 "") +](https://camo.githubusercontent.com/91f9a4433d2cdbf34b4f3469d4e80c2bd21cfa0a/68747470733a2f2f63646e2e6e6c61726b2e636f6d2f6c61726b2f302f323031382f706e672f3132313937312f313533323335323136373137312d33313637633962362d396234392d343639382d623035362d6532363037336536343331322e706e67) + +# Mac终端连接到virtualbox虚拟机 +使用virtualbox创建虚拟机进行工作，可以有效减少本机环境与工作环境之间的相互影响。但由于Server虚拟机的界面不友好，因而使用SSH连接到虚拟机，使用本地终端编辑是一个非常好的选择。 +__1、端口转发__ +点击“设置”-“网络”-“高级”-“端口转发” + + +![image.png | left | 558x389](https://cdn.nlark.com/lark/0/2018/png/135654/1532955458851-bc1c46ed-1ad9-4714-8d4c-1a2deb83f5ec.png "") + + +点击红框中的icon，设置主机端口9022，子系统端口22，保存。 + + +![image.png | left | 550x397](https://cdn.nlark.com/lark/0/2018/png/135654/1532955772003-e4dba259-6dae-46bf-96a8-bc9c38f10115.png "") + +__2、本机终端连接__ +在终端输入 +```plain +$ ssh -p 9022 username@127.0.0.1 +或$ ssh -p 9022 username@localhost +``` +连接成功效果如图所示： + + +![image.png | left | 747x352](https://cdn.nlark.com/lark/0/2018/png/135654/1532956235912-f6789f20-c0e8-4758-8f5e-a76fea5b61b7.png "") + +至此，您已完成环境搭建，并且可以用终端操作，尽情享受PouchContainer吧！ + From a006c4c40c83fa57a0e06096dd41def46c4f01f2 Mon Sep 17 00:00:00 2001 From: yyfcc17 Date: Tue, 31 Jul 2018 02:37:53 +0800 Subject: [PATCH 05/11] Add doc for issue #22, Group 5 --- ...12\346\211\213\346\214\207\345\215\227.md" | 213 +++++++++--------- 1 file changed, 105 insertions(+), 108 deletions(-) diff --git "a/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" "b/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" index 399b392..668240e 100644 --- "a/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" +++ "b/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" @@ -1,108 +1,105 @@ -# 介绍 -PouchContainer 是高效的、轻量级企业级容器引擎技术，拥有隔离性强、可移植性高、资源占用少等特性。它目前仅支持Linux操作系统，故需要使用虚拟机进行本地运行和测试。本篇指南将指导读者在Mac或Windows上搭建基于VirtualBox + Ubuntu16.04的PouchContainer环境。 - -# VirtualBox的安装 -__1、可以从以下方式中选择其一进行安装：__ -* 阿里郎-管家-办公软件管理中搜索VirtualBox，下载并安装。 -* 从 [https://download.virtualbox.org/virtualbox/5.2.16/VirtualBox-5.2.16-123759-OSX.dmg](https://download.virtualbox.org/virtualbox/5.2.16/VirtualBox-5.2.16-123759-OSX.dmg) 下载安装包，下载并安装 -__2、下载完成后，双击VirtualBox.pkg，然后点击“继续”进入安装__ - - -![image.png | left | 506x337](https://cdn.nlark.com/lark/0/2018/png/135654/1532951526444-e74b8693-7e36-40f9-b1da-84d4658d0389.png "") - -__3、自定义安装__ - - -![image.png | left | 502x334](https://cdn.nlark.com/lark/0/2018/png/135654/1532951637319-dd1a8547-4c4c-4db1-91cd-4fb9ec386d93.png "") - -
-
-
- -# VirtualBox的配置 -1、__打开VirtualBox，选择"新建"，新建虚拟机__ - -![image.png | left | 236x61](https://cdn.nlark.com/lark/0/2018/png/124199/1532951984471-9dc5e69b-04d6-4ca3-acfe-cb33341445c4.png "") - -__2、设置新建虚拟电脑的名称和系统类型__ -* 名称-自定义 -* 类型-Linux -* 版本-Ubuntu（64-bit） - - -![image.png | left | 498x449](https://cdn.nlark.com/lark/0/2018/png/124199/1532952147747-22a62b89-a974-4e25-a835-1327ba455f78.png "") - -__3、设置内存大小，可以选择默认大小（1024MB）,点击“继续”__ - -![image.png | left | 497x438](https://cdn.nlark.com/lark/0/2018/png/124199/1532952488126-781dcfd5-521e-46cb-88b0-fe55ddc6c2de.png "") -__4、虚拟硬盘选择：__ -* 选择“使用已有的虚拟硬盘文件”，点击选择文件（选择ubuntuPouch.vdi，此Ubuntu已经安装好了PouchContainer），点击“创建”。 -* 如果没有这样的文件。点击“现在创建虚拟硬盘”，自行配置系统并手动[安装PouchContainer](https://github.com/alibaba/pouch/blob/master/INSTALLATION.md)。 - - -![image.png | left | 493x430](https://cdn.nlark.com/lark/0/2018/png/124199/1532965407472-70a22b38-dfbb-4598-97ce-f2188ad7bd5d.png "") - -# 启动虚拟机并登录pouch -__1、点击“启动”，输入初始的用户名和密码__ -```plain -用户名：pouch -密 码：123456 -``` -__2、切换到root权限__ -```plain -sudo -i -``` -__3、检查网络：__ -```html -ping www.alibaba-inc.com -``` -__4、启动pouch服务（默认开机启动）:__ -``` -systemctl start pouch //如果有问题，请确认网络连接正确 -``` -__5、启动一个已经存在的busybox基础容器：__ -``` -pouch run -t -d busybox sh -``` -__6、如果您没有busybox，可以pull：__ -``` -pouch pull busybox -``` -__7、登录到启动的容器中，其中{ID}是启动命令输出的完整ID中的前六位：__ -``` -pouch exec -it {ID} sh -``` - -操作成功后如图所示： -[ - -![image.png | left | 747x113](https://camo.githubusercontent.com/91f9a4433d2cdbf34b4f3469d4e80c2bd21cfa0a/68747470733a2f2f63646e2e6e6c61726b2e636f6d2f6c61726b2f302f323031382f706e672f3132313937312f313533323335323136373137312d33313637633962362d396234392d343639382d623035362d6532363037336536343331322e706e67 "") -](https://camo.githubusercontent.com/91f9a4433d2cdbf34b4f3469d4e80c2bd21cfa0a/68747470733a2f2f63646e2e6e6c61726b2e636f6d2f6c61726b2f302f323031382f706e672f3132313937312f313533323335323136373137312d33313637633962362d396234392d343639382d623035362d6532363037336536343331322e706e67) - -# Mac终端连接到virtualbox虚拟机 -使用virtualbox创建虚拟机进行工作，可以有效减少本机环境与工作环境之间的相互影响。但由于Server虚拟机的界面不友好，因而使用SSH连接到虚拟机，使用本地终端编辑是一个非常好的选择。 -__1、端口转发__ -点击“设置”-“网络”-“高级”-“端口转发” - - -![image.png | left | 558x389](https://cdn.nlark.com/lark/0/2018/png/135654/1532955458851-bc1c46ed-1ad9-4714-8d4c-1a2deb83f5ec.png "") - - -点击红框中的icon，设置主机端口9022，子系统端口22，保存。 - - -![image.png | left | 550x397](https://cdn.nlark.com/lark/0/2018/png/135654/1532955772003-e4dba259-6dae-46bf-96a8-bc9c38f10115.png "") - -__2、本机终端连接__ -在终端输入 -```plain -$ ssh -p 9022 username@127.0.0.1 -或$ ssh -p 9022 username@localhost -``` -连接成功效果如图所示： - - -![image.png | left | 747x352](https://cdn.nlark.com/lark/0/2018/png/135654/1532956235912-f6789f20-c0e8-4758-8f5e-a76fea5b61b7.png "") - -至此，您已完成环境搭建，并且可以用终端操作，尽情享受PouchContainer吧！ - +# 介绍 +PouchContainer 是高效的、轻量级企业级容器引擎技术，拥有隔离性强、可移植性高、资源占用少等特性。它目前仅支持Linux操作系统，故需要使用虚拟机进行本地运行和测试。本篇指南将指导读者在Mac或Windows上搭建基于VirtualBox + Ubuntu16.04的PouchContainer环境。 + +# VirtualBox的安装 +__1、可以从以下方式中选择其一进行安装：__ +* 阿里郎-管家-办公软件管理中搜索VirtualBox，下载并安装。 +* 从[https://download.virtualbox.org/virtualbox/5.2.16/VirtualBox-5.2.16-123759-OSX.dmg](https://download.virtualbox.org/virtualbox/5.2.16/VirtualBox-5.2.16-123759-OSX.dmg) 下载安装包，下载并安装 + +__2、下载完成后，双击VirtualBox.pkg，然后点击“继续”进入安装__ + +![image.png | left | 506x337](https://cdn.nlark.com/lark/0/2018/png/135654/1532951526444-e74b8693-7e36-40f9-b1da-84d4658d0389.png "") + +__3、自定义安装__ + +![image.png | left | 502x334](https://cdn.nlark.com/lark/0/2018/png/135654/1532951637319-dd1a8547-4c4c-4db1-91cd-4fb9ec386d93.png "") + +# VirtualBox的配置 +1、__打开VirtualBox，选择"新建"，新建虚拟机__ + +![image.png | left | 236x61](https://cdn.nlark.com/lark/0/2018/png/124199/1532951984471-9dc5e69b-04d6-4ca3-acfe-cb33341445c4.png "") + +__2、设置新建虚拟电脑的名称和系统类型__ +* 名称-自定义 +* 类型-Linux +* 版本-Ubuntu（64-bit） + +![image.png | left | 498x449](https://cdn.nlark.com/lark/0/2018/png/124199/1532952147747-22a62b89-a974-4e25-a835-1327ba455f78.png "") + +__3、设置内存大小，可以选择默认大小（1024MB）,点击“继续”__ + +![image.png | left | 497x438](https://cdn.nlark.com/lark/0/2018/png/124199/1532952488126-781dcfd5-521e-46cb-88b0-fe55ddc6c2de.png "") + +__4、虚拟硬盘选择：__ +* 选择“使用已有的虚拟硬盘文件”，点击选择文件（选择ubuntuPouch.vdi，此Ubuntu已安装PouchContainer），点击“创建”。 +* 如果没有这样的文件。点击“现在创建虚拟硬盘”，自行配置系统并手动[安装PouchContainer](https://github.com/alibaba/pouch/blob/master/INSTALLATION.md)。 + +![image.png | left | 493x430](https://cdn.nlark.com/lark/0/2018/png/124199/1532965407472-70a22b38-dfbb-4598-97ce-f2188ad7bd5d.png "") + +# 启动虚拟机并登录pouch +__1、点击“启动”，输入初始的用户名和密码__ +``` +用户名：pouch +密 码：123456 +``` + +__2、切换到root权限__ +``` +sudo -i +``` + +__3、检查网络：__ +``` +ping www.alibaba-inc.com +``` + +__4、启动pouch服务（默认开机启动）:__ +``` +systemctl start pouch //如果有问题，请确认网络连接正确 +``` + +__5、启动一个已经存在的busybox基础容器：__ +``` +pouch run -t -d busybox sh +``` + +__6、如果您没有busybox，可以pull：__ +``` +pouch pull busybox +``` + +__7、登录到启动的容器中，其中{ID}是启动命令输出的完整ID中的前六位：__ +``` +pouch exec -it {ID} sh +``` +操作成功后如图所示： + +![image.png | left | 747x113](https://camo.githubusercontent.com/91f9a4433d2cdbf34b4f3469d4e80c2bd21cfa0a/68747470733a2f2f63646e2e6e6c61726b2e636f6d2f6c61726b2f302f323031382f706e672f3132313937312f313533323335323136373137312d33313637633962362d396234392d343639382d623035362d6532363037336536343331322e706e67 "") + +# Mac终端连接到virtualbox虚拟机 +使用virtualbox创建虚拟机进行工作，可以有效减少本机环境与工作环境之间的相互影响。但由于Server虚拟机的界面不友好，因而使用SSH连接到虚拟机，使用本地终端编辑是一个非常好的选择。 + +__1、端口转发__ +点击“设置”-“网络”-“高级”-“端口转发” + +![image.png | left | 558x389](https://cdn.nlark.com/lark/0/2018/png/135654/1532955458851-bc1c46ed-1ad9-4714-8d4c-1a2deb83f5ec.png "") + +点击红框中的icon，设置主机端口9022，子系统端口22，保存。 + +![image.png | left | 550x397](https://cdn.nlark.com/lark/0/2018/png/135654/1532955772003-e4dba259-6dae-46bf-96a8-bc9c38f10115.png "") + +__2、本机终端连接__ +在终端输入 +``` +$ ssh -p 9022 username@127.0.0.1 +``` +或者 +``` +$ ssh -p 9022 username@localhost +``` +连接成功效果如图所示： + +![image.png | left | 747x352](https://cdn.nlark.com/lark/0/2018/png/135654/1532956235912-f6789f20-c0e8-4758-8f5e-a76fea5b61b7.png "") + +至此，您已完成环境搭建，并且可以用终端操作，尽情享受PouchContainer吧！ + From 0cac954b4482dd68a2ee5c9cc821b80ecb2476b0 Mon Sep 17 00:00:00 2001 From: yyfcc17 Date: Tue, 31 Jul 2018 02:49:35 +0800 Subject: [PATCH 06/11] Add doc for issue #22, Group 5 --- ...nt based on VirtualBox and Ubuntu 16.04.md | 199 +++++++++--------- 1 file changed, 96 insertions(+), 103 deletions(-) diff --git a/blog-en/Building a PouchContainer environment based on VirtualBox and Ubuntu 16.04.md b/blog-en/Building a PouchContainer environment based on VirtualBox and Ubuntu 16.04.md index 58e58c9..0607546 100644 --- a/blog-en/Building a PouchContainer environment based on VirtualBox and Ubuntu 16.04.md +++ b/blog-en/Building a PouchContainer environment based on VirtualBox and Ubuntu 16.04.md @@ -1,103 +1,96 @@ -# Introduction -PouchContainer is a high-efficiency and enterprise-class container engine with the characteristics of strong isolation, high portability and low resource consumption. Currently, PouchContainer only supports the Linux operating system, so a virtual machine is required to run and test locally. This guide instructs the readers to build a PouchContainer environment based on VirtualBox + Ubuntu 16.04 on Mac or Windows. - - -# Installing VirtualBox -__1. You can choose one of the following ways to install Virtualbox:__ -* Search virtualbox from AliLlang (Manager->Software download) , download it, then install -* Download virtualbox from [VirtualBox](https://download.virtualbox.org/virtualbox/5.2.16/VirtualBox-5.2.16-123759-OSX.dmg), then install -2. After finished, double-click VirtualBox.pkg and click Continue to install. - - - -![image.png | left | 564x376](https://cdn.nlark.com/lark/0/2018/png/135654/1532965787724-f8873d75-0db0-44ae-9e76-38e463193304.png "") - -__3.Customizable installation is available__ - - -![image.png | left | 556x370](https://cdn.nlark.com/lark/0/2018/png/135654/1532965968099-0b8e72cc-fe70-452a-a5db-2a8c4fd63d63.png "") - - -# Configuring VirtualBox -1、Open VirtualBox，Click New in the VirtualBox Manager to create a new virtual machine - - -![image.png | left | 265x68](https://cdn.nlark.com/lark/0/2018/png/135654/1532966022381-d6c1f736-be1e-4a84-93ca-f14f33a85d75.png "") - -__2、Input the name, systemm type and version of the new virtual machine.__ -* Choosing a desired name -* Linux type -* Ubuntu (64-bit) version - - -![image.png | left | 538x485](https://cdn.nlark.com/lark/0/2018/png/135654/1532966206015-a825b620-aff5-49b2-b630-9a7302333a8a.png "") - -3、Set the memory size of the virtual machine, or choosing the default size(1024 MB). Then click Next. - - -![image.png | left | 551x485](https://cdn.nlark.com/lark/0/2018/png/135654/1532966237848-4134d823-745d-46ca-bc7b-bb91a029c478.png "") - -4、Virtual hard disk settings -* Choose Using the existing virtual hard disk file, click to choose the file (choose ubuntuPouch.vdi, this Ubuntu has been installed PouchContainer). -* If there is no such a file, click create the virtual hard disk now, and you can configure the system itself and manually install the PouchContainer. Then click create. - - -![image.png | left | 564x492](https://cdn.nlark.com/lark/0/2018/png/135654/1532966506742-18f40273-a294-47cd-b799-bcaf115579d3.png "") - -# Enter the virtual machine, start and log in the pouch. -1、Click start, input the original username and password -``` -username：pouch -password：123456 -``` -__2、Switch to the root user__ -``` -sudo -i -``` -__3、Check network connection__ -``` -ping www.alibaba-inc.com -``` -__4、Start the pouch service (default boot) __ -``` -systemctl start pouch //If not succeed, check the network again -``` -__5、Start an existing busybox base container__ -``` -pouch run -t -d busybox sh -``` -__6、Do pull if no busybox available__ -``` -pouch pull busybox -``` -__7、Log in the started container, the ID is the first 6 digits of the complete IDs from the previous __ -``` -pouch exec -it {ID} sh -``` -command output - - -![image.png | left | 747x113](https://cdn.nlark.com/lark/0/2018/png/135654/1532967272649-b1548c1e-bd10-4487-8dc1-64773bf929fe.png "") - -# Connecting Mac terminal with Virtualbox -Using a virtual machine created by Virtualbox while working can effectively reduce potential interference between the local environment and the working environment. However, the UI of Server is not friendly. Using SSH to connect to virtual machine and local terminals to edit is a suggesting alternative. -__1、Port forwarding__ -1) Click *Setting*, *Internet, Advanced and Port forwarding* - - -![image.png | left | 568x395](https://cdn.nlark.com/lark/0/2018/png/135654/1532967358783-7cb8dc18-6b20-47bd-9fdb-1a2f60d531dc.png "") - -2)Click the icon in red, and set host post *9022， *subsystem port *22*. Then save. - - -![image.png | left | 544x393](https://cdn.nlark.com/lark/0/2018/png/135654/1532967432115-464b2478-dd49-4aa8-ba66-21cca6c1c8fd.png "") - -3)Local terminal connection - -A successful connection interface will be - - -![image.png | left | 614x289](https://cdn.nlark.com/lark/0/2018/png/135654/1532967488069-5a46f6aa-b9c0-4a98-9cb8-feaceaa4c53c.png "") - -Until now, you have finished the environment construction and you can operate on the terminal. Please enjoy your journey on PouchContainer! - +# Introduction +PouchContainer is a high-efficiency and enterprise-class container engine with the characteristics of strong isolation, high portability and low resource consumption. Currently, PouchContainer only supports the Linux operating system, so a virtual machine is required to run and test locally. This guide instructs the readers to build a PouchContainer environment based on VirtualBox + Ubuntu 16.04 on Mac or Windows. + + +# Installing VirtualBox +__1. You can choose one of the following ways to install Virtualbox:__ +* Search virtualbox from AliLlang (Manager->Software download) , download it, then install +* Download virtualbox from [VirtualBox](https://download.virtualbox.org/virtualbox/5.2.16/VirtualBox-5.2.16-123759-OSX.dmg), then install + +__2. After finished, double-click VirtualBox.pkg and click *Continue* to install__ + +![image.png | left | 564x376](https://cdn.nlark.com/lark/0/2018/png/135654/1532965787724-f8873d75-0db0-44ae-9e76-38e463193304.png "") + +__3. Customizable installation is available__ + +![image.png | left | 556x370](https://cdn.nlark.com/lark/0/2018/png/135654/1532965968099-0b8e72cc-fe70-452a-a5db-2a8c4fd63d63.png "") + +# Configuring VirtualBox +__1. OpenVirtualBox，Click New in the VirtualBox Manager to create a new virtual machine__ + +![image.png | left | 265x68](https://cdn.nlark.com/lark/0/2018/png/135654/1532966022381-d6c1f736-be1e-4a84-93ca-f14f33a85d75.png "") + +__2. Input the name, systemm type and version of the new virtual machine__ +* Choosing a desired name +* Linux type +* Ubuntu (64-bit) + +![image.png | left | 538x485](https://cdn.nlark.com/lark/0/2018/png/135654/1532966206015-a825b620-aff5-49b2-b630-9a7302333a8a.png "") + +__3. Set the memory size of the virtual machine, or choosing the default size(1024 MB). Then click Next__ + +![image.png | left | 551x485](https://cdn.nlark.com/lark/0/2018/png/135654/1532966237848-4134d823-745d-46ca-bc7b-bb91a029c478.png "") + +__4. Virtual hard disk settings__ +* Choose Using the existing virtual hard disk file, click to choose the file (choose ubuntuPouch.vdi, this Ubuntu has been installed PouchContainer). +* If there is no such a file, click create the virtual hard disk now, and you can configure the system itself and manually install the PouchContainer. Then click create + +![image.png | left | 564x492](https://cdn.nlark.com/lark/0/2018/png/135654/1532966506742-18f40273-a294-47cd-b799-bcaf115579d3.png "") + +# Start virtual machine and log in the pouch +__1. Click start, input the original username and password__ +``` +username：pouch +password：123456 +``` + +__2、Switch to the root user__ +``` +sudo -i +``` + +__3、Check network connection__ +``` +ping www.alibaba-inc.com +``` + +__4、Start the pouch service (default boot) __ +``` +systemctl start pouch //If not succeed, check the network again +``` + +__5、Start an existing busybox base container__ +``` +pouch run -t -d busybox sh +``` + +__6、Do pull if no busybox available__ +``` +pouch pull busybox +``` + +__7、Log in the started container, the ID is the first 6 digits of the complete IDs from the previous __ +``` +pouch exec -it {ID} sh +``` + +command output + +![image.png | left | 747x113](https://cdn.nlark.com/lark/0/2018/png/135654/1532967272649-b1548c1e-bd10-4487-8dc1-64773bf929fe.png "") + +# Connecting Mac terminal with Virtualbox +Using a virtual machine created by Virtualbox while working can effectively reduce potential interference between the local environment and the working environment. However, the UI of Server is not friendly. Using SSH to connect to virtual machine and local terminals to edit is a suggesting alternative. +__1、Port forwarding__ +* Click *Setting*, *Internet, Advanced and Port forwarding* + +![image.png | left | 568x395](https://cdn.nlark.com/lark/0/2018/png/135654/1532967358783-7cb8dc18-6b20-47bd-9fdb-1a2f60d531dc.png "") + +* Click the icon, set host post as **9022** and subsystem port as **22**. Then save. + +![image.png | left | 544x393](https://cdn.nlark.com/lark/0/2018/png/135654/1532967432115-464b2478-dd49-4aa8-ba66-21cca6c1c8fd.png "") + +* Local terminal connection and a successful connection interface will be: + +![image.png | left | 614x289](https://cdn.nlark.com/lark/0/2018/png/135654/1532967488069-5a46f6aa-b9c0-4a98-9cb8-feaceaa4c53c.png "") + +Until now, you have finished the environment construction and you can operate on the terminal. Please enjoy your journey on PouchContainer! From c2b5988b8882d8cc7e6c1e04a56cd442c01c220e Mon Sep 17 00:00:00 2001 From: yyfcc17 Date: Tue, 31 Jul 2018 03:15:39 +0800 Subject: [PATCH 07/11] Add English doc for #22, Group 5 --- ...nt based on VirtualBox and Ubuntu 16.04.md | 44 ++++++++++++------- 1 file changed, 28 insertions(+), 16 deletions(-) diff --git a/blog-en/Building a PouchContainer environment based on VirtualBox and Ubuntu 16.04.md b/blog-en/Building a PouchContainer environment based on VirtualBox and Ubuntu 16.04.md index 0607546..9b51d83 100644 --- a/blog-en/Building a PouchContainer environment based on VirtualBox and Ubuntu 16.04.md +++ b/blog-en/Building a PouchContainer environment based on VirtualBox and Ubuntu 16.04.md @@ -16,60 +16,60 @@ __3. Customizable installation is available__ ![image.png | left | 556x370](https://cdn.nlark.com/lark/0/2018/png/135654/1532965968099-0b8e72cc-fe70-452a-a5db-2a8c4fd63d63.png "") # Configuring VirtualBox -__1. OpenVirtualBox，Click New in the VirtualBox Manager to create a new virtual machine__ +__1. Open VirtualBox. Click New in the VirtualBox Manager to create a new virtual machine__ ![image.png | left | 265x68](https://cdn.nlark.com/lark/0/2018/png/135654/1532966022381-d6c1f736-be1e-4a84-93ca-f14f33a85d75.png "") -__2. Input the name, systemm type and version of the new virtual machine__ +__2. Input the name, system type and version of the new virtual machine__ * Choosing a desired name * Linux type * Ubuntu (64-bit) ![image.png | left | 538x485](https://cdn.nlark.com/lark/0/2018/png/135654/1532966206015-a825b620-aff5-49b2-b630-9a7302333a8a.png "") -__3. Set the memory size of the virtual machine, or choosing the default size(1024 MB). Then click Next__ +__3. Set the memory size of the virtual machine, or choose the default size(1024 MB). Then click *Next*__ ![image.png | left | 551x485](https://cdn.nlark.com/lark/0/2018/png/135654/1532966237848-4134d823-745d-46ca-bc7b-bb91a029c478.png "") __4. Virtual hard disk settings__ -* Choose Using the existing virtual hard disk file, click to choose the file (choose ubuntuPouch.vdi, this Ubuntu has been installed PouchContainer). -* If there is no such a file, click create the virtual hard disk now, and you can configure the system itself and manually install the PouchContainer. Then click create +* Choose *Using the existing virtual hard disk file*, click to choose the file ( ubuntuPouch.vdi, PouchContainer has been installed in Ubuntu ). +* If there is no such a file, click *create the virtual hard disk now*, and you can configure the system itself and manually install the PouchContainer. Then click *Create* ![image.png | left | 564x492](https://cdn.nlark.com/lark/0/2018/png/135654/1532966506742-18f40273-a294-47cd-b799-bcaf115579d3.png "") # Start virtual machine and log in the pouch -__1. Click start, input the original username and password__ +__1. Click *Start*, input the original username and password__ ``` username：pouch password：123456 ``` -__2、Switch to the root user__ +__2. Switch to the root user__ ``` sudo -i ``` -__3、Check network connection__ +__3. Check network connection__ ``` ping www.alibaba-inc.com ``` -__4、Start the pouch service (default boot) __ +__4. Start the pouch service (default boot)__ ``` -systemctl start pouch //If not succeed, check the network again +systemctl start pouch # If not succeed, check the network again ``` -__5、Start an existing busybox base container__ +__5. Start an existing busybox container__ ``` pouch run -t -d busybox sh ``` -__6、Do pull if no busybox available__ +__6. Pull busybox if not available__ ``` pouch pull busybox ``` -__7、Log in the started container, the ID is the first 6 digits of the complete IDs from the previous __ +__7. Log in the started container, the {ID} is the first 6 digits of the complete ID from the previous output__ ``` pouch exec -it {ID} sh ``` @@ -80,8 +80,9 @@ command output # Connecting Mac terminal with Virtualbox Using a virtual machine created by Virtualbox while working can effectively reduce potential interference between the local environment and the working environment. However, the UI of Server is not friendly. Using SSH to connect to virtual machine and local terminals to edit is a suggesting alternative. -__1、Port forwarding__ -* Click *Setting*, *Internet, Advanced and Port forwarding* + +__1. Port forwarding__ +* Click *Setting*, *Internet, Advanced* and *Port forwarding* ![image.png | left | 568x395](https://cdn.nlark.com/lark/0/2018/png/135654/1532967358783-7cb8dc18-6b20-47bd-9fdb-1a2f60d531dc.png "") @@ -89,7 +90,18 @@ __1、Port forwarding__ ![image.png | left | 544x393](https://cdn.nlark.com/lark/0/2018/png/135654/1532967432115-464b2478-dd49-4aa8-ba66-21cca6c1c8fd.png "") -* Local terminal connection and a successful connection interface will be: +__2. Local terminal connection __ + +* Input to the terminal +``` +$ ssh -p 9022 username@127.0.0.1 +``` +or +``` +$ ssh -p 9022 username@localhost +``` + +* A successful connection interface will be: ![image.png | left | 614x289](https://cdn.nlark.com/lark/0/2018/png/135654/1532967488069-5a46f6aa-b9c0-4a98-9cb8-feaceaa4c53c.png "") From 406cc6891f8f228df4ebc0e49fb4255e50fc9c11 Mon Sep 17 00:00:00 2001 From: yyfcc17 Date: Tue, 31 Jul 2018 03:19:52 +0800 Subject: [PATCH 08/11] Add Chinese doc for #22, Group 5 --- ...\212\346\211\213\346\214\207\345\215\227.md" | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git "a/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" "b/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" index 668240e..f6f3be9 100644 --- "a/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" +++ "b/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" @@ -26,7 +26,7 @@ __2、设置新建虚拟电脑的名称和系统类型__ ![image.png | left | 498x449](https://cdn.nlark.com/lark/0/2018/png/124199/1532952147747-22a62b89-a974-4e25-a835-1327ba455f78.png "") -__3、设置内存大小，可以选择默认大小（1024MB）,点击“继续”__ +__3、设置内存大小，可以选择默认大小（1024MB），点击“继续”__ ![image.png | left | 497x438](https://cdn.nlark.com/lark/0/2018/png/124199/1532952488126-781dcfd5-521e-46cb-88b0-fe55ddc6c2de.png "") @@ -48,27 +48,27 @@ __2、切换到root权限__ sudo -i ``` -__3、检查网络：__ +__3、检查网络__ ``` ping www.alibaba-inc.com ``` -__4、启动pouch服务（默认开机启动）:__ +__4、启动pouch服务（默认开机启动）__ ``` -systemctl start pouch //如果有问题，请确认网络连接正确 +systemctl start pouch # 如果有问题，请确认网络连接正确 ``` -__5、启动一个已经存在的busybox基础容器：__ +__5、启动一个已经存在的busybox基础容器__ ``` pouch run -t -d busybox sh ``` -__6、如果您没有busybox，可以pull：__ +__6、如果您没有busybox，可以pull__ ``` pouch pull busybox ``` -__7、登录到启动的容器中，其中{ID}是启动命令输出的完整ID中的前六位：__ +__7、登录到启动的容器中，其中{ID}是启动命令输出的完整ID中的前六位__ ``` pouch exec -it {ID} sh ``` @@ -84,11 +84,12 @@ __1、端口转发__ ![image.png | left | 558x389](https://cdn.nlark.com/lark/0/2018/png/135654/1532955458851-bc1c46ed-1ad9-4714-8d4c-1a2deb83f5ec.png "") -点击红框中的icon，设置主机端口9022，子系统端口22，保存。 +点击红框中的icon，设置主机端口**9022**，子系统端口**22**，保存。 ![image.png | left | 550x397](https://cdn.nlark.com/lark/0/2018/png/135654/1532955772003-e4dba259-6dae-46bf-96a8-bc9c38f10115.png "") __2、本机终端连接__ + 在终端输入 ``` $ ssh -p 9022 username@127.0.0.1 From 1d1195a136d67c0c8ba446c6f6526bcc1ebd9232 Mon Sep 17 00:00:00 2001 From: yyfcc17 Date: Tue, 31 Jul 2018 03:34:29 +0800 Subject: [PATCH 09/11] Add Chinese doc for #22, Group 5 --- ...4\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" | 1 + 1 file changed, 1 insertion(+) diff --git "a/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" "b/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" index f6f3be9..f380459 100644 --- "a/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" +++ "b/blog-cn/\345\237\272\344\272\216VirtualBox + Ubuntu16.04 \347\232\204 PouchContainer \344\275\223\351\252\214\347\216\257\345\242\203\346\220\255\345\273\272\344\270\216\344\270\212\346\211\213\346\214\207\345\215\227.md" @@ -80,6 +80,7 @@ pouch exec -it {ID} sh 使用virtualbox创建虚拟机进行工作，可以有效减少本机环境与工作环境之间的相互影响。但由于Server虚拟机的界面不友好，因而使用SSH连接到虚拟机，使用本地终端编辑是一个非常好的选择。 __1、端口转发__ + 点击“设置”-“网络”-“高级”-“端口转发” ![image.png | left | 558x389](https://cdn.nlark.com/lark/0/2018/png/135654/1532955458851-bc1c46ed-1ad9-4714-8d4c-1a2deb83f5ec.png "") From 64d67b0590825df2e763531c29ce020f4a80cfd8 Mon Sep 17 00:00:00 2001 From: yyfcc17 Date: Tue, 31 Jul 2018 03:36:34 +0800 Subject: [PATCH 10/11] Add Chinese doc for #66, Group 5 --- ...345\270\246prometheus\347\232\204pouch.md" | 75 +++++++++ ...6\217\222\344\273\266\347\232\204pouch.md" | 147 ++++++++++++++++++ 2 files changed, 222 insertions(+) create mode 100644 "blog-cn/\345\270\246prometheus\347\232\204pouch.md" create mode 100644 "blog-cn/\345\270\246\346\217\222\344\273\266\347\232\204pouch.md" diff --git "a/blog-cn/\345\270\246prometheus\347\232\204pouch.md" "b/blog-cn/\345\270\246prometheus\347\232\204pouch.md" new file mode 100644 index 0000000..303f7b8 --- /dev/null +++ "b/blog-cn/\345\270\246prometheus\347\232\204pouch.md" @@ -0,0 +1,75 @@ +# Prometheus加持的PouchContainer + +`PouchContainer`通过`Prometheus`支持多种监测指标。我们现在已经有了基本的`golang`的运行环境和一些api延时指标。我们将在以下两个主要领域中增加更多的评测指标： +* 重要的`pouchd`评测指标 +* 重要的api延时评测指标列表 + +## 如何增加新评测指标 + +我们倾向于在`PouchContainer`使用`prometheus`的[评测指标和标签命名约定](https://prometheus.io/docs/practices/naming/)。因此，当你要添加新的评测指标时，请遵循`prometheus`的评测指标和标签命名约定。 + +我们使用`promethus` 的[go-sdk](https://github.com/prometheus/client_golang) 去监测`pouchd`。它支持计数器、计量和概要等度量指标。请参考 [指标类型](https://prometheus.io/docs/concepts/metric_types/) 以获得更多信息。 + +## 如何使用 + +用户可通过`pouchd -l tcp://0.0.0.0:4243`指令启动`pouchd`来监听`0.0.0.0:4243`，然后发出`GET http://127.0.0.1:4243/metrics`请求以获取`prometheus`格式的评测指标的完整列表，具体如下： + +``` +# HELP go_gc_duration_seconds A summary of the GC invocation durations. +# TYPE go_gc_duration_seconds summary +go_gc_duration_seconds{quantile="0"} 0.000111176 +go_gc_duration_seconds{quantile="0.25"} 0.000198062 +go_gc_duration_seconds{quantile="0.5"} 0.000269599 +go_gc_duration_seconds{quantile="0.75"} 0.000474291 +go_gc_duration_seconds{quantile="1"} 0.002013351 +go_gc_duration_seconds_sum 0.021835193 +go_gc_duration_seconds_count 52 +# HELP go_goroutines Number of goroutines that currently exist. +# TYPE go_goroutines gauge +go_goroutines 22 +# HELP go_info Information about the Go environment. +# TYPE go_info gauge +go_info{version="go1.9"} 1 +... +# HELP http_request_size_bytes The HTTP request sizes in bytes. +# TYPE http_request_size_bytes summary +http_request_size_bytes{handler="prometheus",quantile="0.5"} NaN +http_request_size_bytes{handler="prometheus",quantile="0.9"} NaN +http_request_size_bytes{handler="prometheus",quantile="0.99"} NaN +http_request_size_bytes_sum{handler="prometheus"} 0 +http_request_size_bytes_count{handler="prometheus"} 0 +# HELP http_response_size_bytes The HTTP response sizes in bytes. +# TYPE http_response_size_bytes summary +http_response_size_bytes{handler="prometheus",quantile="0.5"} NaN +http_response_size_bytes{handler="prometheus",quantile="0.9"} NaN +http_response_size_bytes{handler="prometheus",quantile="0.99"} NaN +http_response_size_bytes_sum{handler="prometheus"} 0 +http_response_size_bytes_count{handler="prometheus"} 0 +# HELP pouch_image_pull_latency_microseconds Latency in microseconds to pull a image. +# TYPE pouch_image_pull_latency_microseconds summary +pouch_image_pull_latency_microseconds{image="docker.io/library/ubuntu:latest",quantile="0.5"} 3.7803132e+07 +pouch_image_pull_latency_microseconds{image="docker.io/library/ubuntu:latest",quantile="0.9"} 3.7803132e+07 +pouch_image_pull_latency_microseconds{image="docker.io/library/ubuntu:latest",quantile="0.99"} 3.7803132e+07 +pouch_image_pull_latency_microseconds_sum{image="docker.io/library/ubuntu:latest"} 3.7803132e+07 +pouch_image_pull_latency_microseconds_count{image="docker.io/library/ubuntu:latest"} 1 +# HELP process_cpu_seconds_total Total user and system CPU time spent in seconds. +# TYPE process_cpu_seconds_total counter +process_cpu_seconds_total 4.78 +# HELP process_max_fds Maximum number of open file descriptors. +# TYPE process_max_fds gauge +process_max_fds 1024 +# HELP process_open_fds Number of open file descriptors. +# TYPE process_open_fds gauge +process_open_fds 9 +# HELP process_resident_memory_bytes Resident memory size in bytes. +# TYPE process_resident_memory_bytes gauge +process_resident_memory_bytes 3.4521088e+07 +# HELP process_start_time_seconds Start time of the process since unix epoch in seconds. +# TYPE process_start_time_seconds gauge +process_start_time_seconds 1.51064406778e+09 +# HELP process_virtual_memory_bytes Virtual memory size in bytes. +# TYPE process_virtual_memory_bytes gauge +process_virtual_memory_bytes 4.91610112e+08 +``` + +这样，我们可以在`prometheus`中设置新目标以获得评价指标在每轮迭代中的取值。 \ No newline at end of file diff --git "a/blog-cn/\345\270\246\346\217\222\344\273\266\347\232\204pouch.md" "b/blog-cn/\345\270\246\346\217\222\344\273\266\347\232\204pouch.md" new file mode 100644 index 0000000..692b2b0 --- /dev/null +++ "b/blog-cn/\345\270\246\346\217\222\344\273\266\347\232\204pouch.md" @@ -0,0 +1,147 @@ +# 带插件的PouchContainer + +为了让用户运行自定义代码，`golang 1.8`支持引入插件框架。在插件框架中，我们支持用户在以下阶段添加自定义代码： + +- 预启动守护阶段 +- 预停止守护阶段 +- 预创建容器阶段 +- 预启动容器阶段 +- 预创建端点容器阶段 + +以上5个阶段点由`DaemonPlugin`和`ContainerPlugin`组织，两个插件定义如下： + +``` +// DaemonPlugin defines in which place does pouchd support plugin +type DaemonPlugin interface { + // PreStartHook is invoked by pouchd before real start, in this hook user could start dfget proxy or other + // standalone process plugins + PreStartHook() error + + // PreStopHook is invoked by pouchd before daemon process exit, not a promise if daemon is killed, in this + // hook user could stop the process or plugin started by PreStartHook + PreStopHook() error +} + +// ContainerPlugin defines places where a plugin will be triggered in container lifecycle +type ContainerPlugin interface { + // PreCreate defines plugin point where receives an container create request, in this plugin point user + // could change the container create body passed-in by http request body + PreCreate(io.ReadCloser) (io.ReadCloser, error) + + // PreStart returns an array of priority and args which will pass to runc, the every priority + // used to sort the pre start array that pass to runc, network plugin hook always has priority value 0. + PreStart(interface{}) ([]int, [][]string, error) + + //NetworkGenericParams accepts the container id and env of this container and returns the priority of this endpoint + // and if this endpoint should enable resolver and a map which will be used as generic params to create endpoints of + // this container + PreCreateEndpoint(string, []string) (priority int, disableResolver bool, genericParam map[string]interface{}) +} +``` + +这两个插件符号将通过名称`DaemonPlugin`和`ContainerPlugin`从共享对象文件中获取，如下所示： + +``` +p, _ := plugin.Open("path_to_shared_object_file") +daemonPlugin, _ := p.Lookup("DaemonPlugin") +containerPlugin, _ := p.Lookup("ContainerPlugin") +``` + +## 范例 + +定义两个在对应阶段打印日志的插件符号： + +``` +package main + +import ( + "fmt" + "io" +) + +var ContainerPlugin ContPlugin + +type ContPlugin int + +var DaemonPlugin DPlugin + +type DPlugin int + +func (d DPlugin) PreStartHook() error { + fmt.Println("pre-start hook in daemon is called") + return nil +} + +func (d DPlugin) PreStopHook() error { + fmt.Println("pre-stop hook in daemon is called") + return nil +} + +func (c ContPlugin) PreCreate(in io.ReadCloser) (io.ReadCloser, error) { + fmt.Println("pre create method called") + return in, nil +} + +func (c ContPlugin) PreStart(interface{}) ([]int, [][]string, error) { + fmt.Println("pre start method called") + // make this pre-start hook run after network in container setup + return []int{-4}, [][]string{{"/usr/bin/touch", "touch", "/tmp/pre_start_hook"}}, nil +} + +func (c ContPlugin) PreCreateEndpoint(string, []string) (priority int, disableResolver bool, genericParam map[string]interface{}) { + fmt.Println("pre create endpoint") + return +} + +func main() { + fmt.Println(ContainerPlugin, DaemonPlugin) +} +``` + +用如下命令行生成： + +``` +go build -buildmode=plugin -ldflags "-pluginpath=plugins_$(date +%s)" -o hook_plugin.so +``` + +要使用生成的共享对象文件，启动`--plugin = path_to_hook_plugin.so` flag 的 pouchd，然后当你启动停止守护进程并创建容器时，在日志中会有如下日志： + +``` +pre-start hook in daemon is called +pre create method called +pre-stop hook in daemon is called +``` + +当你启动一个容器时，config.json文件（其地址为$ home_dir / containerd / state / io.containerd.runtime.v1.linux / default / $ container_id / config.json）将包含以上代码中定义的预启动挂钩，例如： + +``` +"hooks": { + "prestart": [ + { + "args": [ + "libnetwork-setkey", + "f67df14e96fa4b94a6e386d0795bdd2703ca7b01713d48c9567203a37b05ae3d", + "8e3d8db7f72a66edee99d4db6ab911f8d618af057485731e9acf24b3668e25b6" + ], + "path": "/usr/local/bin/pouchd" + }, + { + "args": [ + "touch", + "/tmp/pre_start_hook" + ], + "path": "/usr/bin/touch" + } + ] + } +``` + +如果你使用如上代码，每当你启动容器，路径`/tmp/pre_start_hook`下的文件将被调用。 + +## 使用 + +- 在预启动守护程序阶段，您可以启动协助过程，如网络插件和dfget代理，其需要pouchd，并且其生命周期与pouchd相同。 +- 在预停止守护程序阶段，你可以优雅地停止辅助进程，但这并不是实时有效，因为可能会被SIGKILL杀死。 +- 在容器的预创建阶段，你可以根据一些规则改变输入流，在一些公司里面他们会有过时的编排系统，其用环境变量来传递一些限制条件，这些环境变量是pouchContainer中的属性。你可以在预创建阶段将环境变量的值转换成PouchContainer create Api中用到的ContainerConfig或者HostConfig的属性。 +- 在容器的预开始阶段，你可以设置更多针对oci规格的钩子，你可以在入口启动开始前做一些特殊的事情，也可以针对钩子运行的顺序设置优先级。libnetwork的优先级是0，所以如果你期望它在容器启动阶段时先于network运行，你就该给它设一个大于0的优先级，反之亦然。 +- 在容器的端点预创建阶段，你可以返回端点的优先级和该端点是否需要激活分解器以及该端点的通用参数。 \ No newline at end of file From 367146744f3bb7745cfeabfad3f9872a2791a530 Mon Sep 17 00:00:00 2001 From: yyfcc17 Date: Tue, 31 Jul 2018 10:02:09 +0800 Subject: [PATCH 11/11] fix typo --- blog-en/pouch_with_plugin.md | 148 +++++++++++++++++++++++++++++++++++ 1 file changed, 148 insertions(+) create mode 100644 blog-en/pouch_with_plugin.md diff --git a/blog-en/pouch_with_plugin.md b/blog-en/pouch_with_plugin.md new file mode 100644 index 0000000..100db09 --- /dev/null +++ b/blog-en/pouch_with_plugin.md @@ -0,0 +1,148 @@ +# PouchContainer with plugin + +In order to run custom code provided by users which will be triggered at some point, we support a plugin framework which introduced from golang 1.8. At this time in this plugin framework we enable users to add custom code at file points: + +* pre-start daemon point +* pre-stop daemon point +* pre-create container point +* pre-start container point +* pre-create-endpoint container point + +Above five points are organized by two Plugin interfaces, which are DaemonPlugin and ContainerPlugin, defined as follow: + +``` +// DaemonPlugin defines in which place does pouchd support plugin +type DaemonPlugin interface { + // PreStartHook is invoked by pouchd before real start, in this hook user could start dfget proxy or other + // standalone process plugins + PreStartHook() error + + // PreStopHook is invoked by pouchd before daemon process exit, not a promise if daemon is killed, in this + // hook user could stop the process or plugin started by PreStartHook + PreStopHook() error +} + +// ContainerPlugin defines places where a plugin will be triggered in container lifecycle +type ContainerPlugin interface { + // PreCreate defines plugin point where receives an container create request, in this plugin point user + // could change the container create body passed-in by http request body + PreCreate(io.ReadCloser) (io.ReadCloser, error) + + // PreStart returns an array of priority and args which will pass to runc, the every priority + // used to sort the pre start array that pass to runc, network plugin hook always has priority value 0. + PreStart(interface{}) ([]int, [][]string, error) + + //NetworkGenericParams accepts the container id and env of this container and returns the priority of this endpoint + // and if this endpoint should enable resolver and a map which will be used as generic params to create endpoints of + // this container + PreCreateEndpoint(string, []string) (priority int, disableResolver bool, genericParam map[string]interface{}) +} + +``` + +These two Plugin symbols will be fetch by name `DaemonPlugin` and `ContainerPlugin` from shared object file like this: + +``` +p, _ := plugin.Open("path_to_shared_object_file") +daemonPlugin, _ := p.Lookup("DaemonPlugin") +containerPlugin, _ := p.Lookup("ContainerPlugin") +``` + +## example + +define two plugin symbols which only print some logs at correspond point: + +``` +package main + +import ( + "fmt" + "io" +) + +var ContainerPlugin ContPlugin + +type ContPlugin int + +var DaemonPlugin DPlugin + +type DPlugin int + +func (d DPlugin) PreStartHook() error { + fmt.Println("pre-start hook in daemon is called") + return nil +} + +func (d DPlugin) PreStopHook() error { + fmt.Println("pre-stop hook in daemon is called") + return nil +} + +func (c ContPlugin) PreCreate(in io.ReadCloser) (io.ReadCloser, error) { + fmt.Println("pre create method called") + return in, nil +} + +func (c ContPlugin) PreStart(interface{}) ([]int, [][]string, error) { + fmt.Println("pre start method called") + // make this pre-start hook run after network in container setup + return []int{-4}, [][]string{{"/usr/bin/touch", "touch", "/tmp/pre_start_hook"}}, nil +} + +func (c ContPlugin) PreCreateEndpoint(string, []string) (priority int, disableResolver bool, genericParam map[string]interface{}) { + fmt.Println("pre create endpoint") + return +} + +func main() { + fmt.Println(ContainerPlugin, DaemonPlugin) +} +``` + +then build it with command line like: + +``` +go build -buildmode=plugin -ldflags "-pluginpath=plugins_$(date +%s)" -o hook_plugin.so +``` + +to use the shared object file generated, start pouchd which flag `--plugin=path_to_hook_plugin.so`, then when you start stop daemon and create container, in the log there will be some logs like: + +``` +pre-start hook in daemon is called +pre create method called +pre-stop hook in daemon is called +``` + +when you start a container, the config.json file (whose place is $home_dir/containerd/state/io.containerd.runtime.v1.linux/default/$container_id/config.json) will contains the pre-start hook specified in above code, eg: + +``` + "hooks": { + "prestart": [ + { + "args": [ + "libnetwork-setkey", + "f67df14e96fa4b94a6e386d0795bdd2703ca7b01713d48c9567203a37b05ae3d", + "8e3d8db7f72a66edee99d4db6ab911f8d618af057485731e9acf24b3668e25b6" + ], + "path": "/usr/local/bin/pouchd" + }, + { + "args": [ + "touch", + "/tmp/pre_start_hook" + ], + "path": "/usr/bin/touch" + } + ] + } +``` + +and if you use the exact code above, every time you start a container the file at /tmp/pre_start_hook will be touched. + +## usage + +* at pre-start daemon point you can start assist processes like network plugins and dfget proxy which need by pouchd and whose life cycle is the same as pouchd. +* at pre-stop daemon point you can stop the assist processes gracefully, but the trigger of this point is not a promise, because pouchd may be killed by SIGKILL. +* at pre-create container point you can change the input stream by some rules, in some company they have some stale orchestration system who use env to pass-in some limit which is an attribute in PouchContainer, then you can use this point to convert value in env to attribute in ContainerConfig or HostConfig of PouchContainer create api. +* at pre-start container point you can set more pre-start hooks to oci spec, where you can do some special thing before container entrypoint start, priority decide the order of executing of the hook. libnetwork hook has priority 0, so if the hook is expected to run before network in container setup you should set priority to a value big then 0, and vice versa. +* at pre-create-endpoint container point you can return the priority of this endpoint and if this endpoint need enable resolver and the generic params of this endpoint.