月份彙整: 2021 年 6 月

容器技術之Dockerfile（一）_網頁設計公司

發佈日期: 作者:

※綠能、環保無空污,成為電動車最新代名詞，目前市場使用率逐漸普及化

台中景泰電動車行只是一個單純的理由，將來台灣的環境，出門可以自由放心的深呼吸，讓空氣回歸自然的乾淨，減少污染，留給我們下一代有好品質無空污的優質環境

　　在前邊的隨筆中我們聊到了docker的基本命令，鏡像，網絡，存儲卷以及基於現有容器製做docker鏡像，相關隨筆可參考https://www.cnblogs.com/qiuhom-1874/category/1766327.html；今天我們來聊一聊docker的另一個製作鏡像的方式dockerfile;

　　什麼是dockerfile?所謂dockerfile就是用來描述docker鏡像製作過程的一指令文件；該文件是一個純文本文件，docker Daemon 進程可以從該文件中讀取指令，從而自動生成鏡像；客戶端可以使用docker bulid命令來指定dockerfile 所在目錄，來生成以dockerfile里描述的鏡像構建過程的鏡像；

　　首先我們來了解下dockerfile的格式，dockerfile是一個純文本文件，我們可以理解為構建鏡像的源碼；不同於其他編程語言，dockerfile里沒有if else 沒有循環，它裏面僅僅有註釋和構建鏡像的指令；對於dockerfile註釋就是以井號開頭的行為註釋，這個和shell和其他配置文件的語法一樣；除此之外dockerfile里就只有指令了；嚴格的講指令是不區分字符大小寫的，通常我們約定俗成指令都是純大寫；除此之外在dockerfile的第一非註釋行必須是FROM開頭來明確的說明我們在基於那個鏡像為基礎鏡像做鏡像；

　　通常情況下dockerfile是放在一個目錄下，該目錄就是dockerfile的工作目錄，我們在製作鏡像所依賴的文件都必須放在該目錄下，而dockerfile的名稱也必須是Dockerfile（首字母大寫，名稱必須是Dockerfile），如果我們依賴的文件是一個目錄下的部分文件，我們也可在dockerfile所在目錄創建一個.dockerignore文件，把我們要忽略的文件名稱寫到裏面即可，該文件支持通配符；

　　了解了上面的dockerfile的基本環境結構，接下來我們來說說dockerfile的指令的用法；

　　1、FROM：用於指定所創建鏡像的基礎鏡像，如果本地不存在，默認會從dockerhub中下載；該指令是dockerfile里的第一個非註釋行的指令；語法格式 FROM <repository>[:<tag>] 或者FROM <repository>@<digest>  其中repository是指定的base 鏡像的名稱 <tag>是base 鏡像的標籤為可選項，不指定標籤默認表示使用指定鏡像的latest版本；

　　2、MAINTAINER：用於指定維護者信息，dockerfile並不限制MAINTAINER指令可出現的位置，通常我們建議將該指令放在FROM之後；語法格式 MAINTAINER <authtor’s detail>， <author’s detail>可是任何文本信息，但約定俗成地使用作者名稱及郵件地址；

　　示例：

[root@node1 test]# cat Dockerfile 
FROM busybox:latest

MAINTAINER "qiuhom <qiuhom@linux-1874.com>"


[root@node1 test]#

　　提示：通常我們都不用MAINTAINER來指定作者信息，該指令幾乎是廢棄狀態，建議使用LEBEL指令來指定；

　　3、LABEL：該指令用於指定添加鏡像的元數據信息；語法格式為LABEL <key>=<value> <key>=<value> <key>=<value> …；如果添加的元數據信息值中有空格，我們需要使用引號和反斜線進行命令行解析；

　　示例：

[root@node1 test]# cat Dockerfile 
FROM busybox:latest

MAINTAINER "qiuhom <qiuhom@linux-1874.com>"

LABEL version="1.0"

LABEL description="this is test file \ that label-values can span multiple lines."


[root@node1 test]#

　　提示：LABEL指令可以使用多次，用於添加更多的元數據信息；

　　4、COPY：該指令用於從Docker主機複製文件至創建的鏡像文件中；語法格式 COPY <src> … <dest> 或 COPY [“<src>”,… “<dest>”]；<src>表示要複製的源文件或目錄，支持使用通配符；<dest>表示目標路徑，即正在創建的image的文件系統路徑；建議為<dest>使用絕對路徑，否則，COPY指定則以WORKDIR為其起始路徑；注意：在路徑中有空白字符時，通常使用第二種格式；

　　文件複製準則

　　1、<src>必須是Dockerfile所在目錄中的文件，不能是其父目錄中的文件；

　　2、如果<src>是目錄，則其內部文件或子目錄會被遞歸複製，但<src>目錄自身不會被複制；

　　3、如果指定了多個<src>,或在<src>中使用了通配符，則<dest>必須是一個目錄，且必須以“/”結尾；

　　4、如果<dest>事先不存在，它會被自動創建，則包括其父目錄路徑；

　　示例：

[root@node1 test]# cat Dockerfile 
FROM busybox:latest

MAINTAINER "qiuhom <qiuhom@linux-1874.com>"

LABEL version="1.0"

LABEL description="this is test file \ that label-values can span multiple lines."

COPY html /var/www/html/

COPY test.html /tmp/
[root@node1 test]# tree
.
├── Dockerfile
├── html
│   ├── test1.html
│   └── test2.html
└── test.html

1 directory, 4 files
[root@node1 test]#

　　測試：我們基於上面的Dockerfile構建鏡像，看看構建好的鏡像是否把對應文件都複製到對應目錄下了？

[root@node1 test]# ls
Dockerfile  html  test.html
[root@node1 test]# pwd
/root/test
[root@node1 test]# docker build . -t myimg:v0.1
Sending build context to Docker daemon  5.632kB
Step 1/6 : FROM busybox:latest
latest: Pulling from library/busybox
d9cbbca60e5f: Pull complete 
Digest: sha256:836945da1f3afe2cfff376d379852bbb82e0237cb2925d53a13f53d6e8a8c48c
Status: Downloaded newer image for busybox:latest
 ---> 78096d0a5478
Step 2/6 : MAINTAINER "qiuhom <qiuhom@linux-1874.com>"
 ---> Running in c311afd3d522
Removing intermediate container c311afd3d522
 ---> bf9b966a914b
Step 3/6 : LABEL version="1.0"
 ---> Running in 2ffb577afa08
Removing intermediate container 2ffb577afa08
 ---> 5dd2e4b3f594
Step 4/6 : LABEL description="this is test file \ that label-values can span multiple lines."
 ---> Running in 489165bad668
Removing intermediate container 489165bad668
 ---> 994f06ff65f8
Step 5/6 : COPY html /var/www/html/
 ---> f2b46094d9a9
Step 6/6 : COPY test.html /tmp/
 ---> c78c7188f804
Successfully built c78c7188f804
Successfully tagged myimg:v0.1
[root@node1 test]# docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
myimg               v0.1                c78c7188f804        8 seconds ago       1.22MB
busybox             latest              78096d0a5478        2 weeks ago         1.22MB
[root@node1 test]#

　　提示:可以看到docker在讀dockerfile時會把一條指令啟動一容器來執行,然後每一條指令都會構建成一層鏡像;如果我們本地倉庫中沒有我們指定的基礎鏡像,它默認會從dockerhub倉庫中去把指定鏡像拖到本地;docker build命令是用來基於dockerfile來製作鏡像的命令,其中-t表示指定我們生成的鏡像的標籤信息;

　　運行我們剛才製作好的鏡像,看看我們的指定的目錄和文件是否都複製到指定鏡像中的目錄中去了?

[root@node1 test]# docker run --name test --rm -it myimg:v0.1 /bin/sh
/ # ls
bin   dev   etc   home  proc  root  sys   tmp   usr   var
/ # ls /var/www/html/
test1.html  test2.html
/ # ls /tmp/
test.html
/ # cat /var/www/html/test1.html 
this is test1 html
/ # cat /var/www/html/test2.html 
this is test2 html
/ # cat /tmp/test.html 
this is test dir html
/ # exit
[root@node1 test]#

　　提示:可以看到我們以剛才製作的鏡像運行成容器,容器對應目錄有我們指定複製的文件;
　　5、ADD：該指令類似於COPY指令，ADD支持使用TAR文件和URL路徑；語法格式 ADD <src> … <dest> 或 ADD [“<src>”,… “<dest>”]；如果<src>為URL且<dest>不以/結尾，則<src>指定的文件將被下載並直接被創建為<dest>；如果<dest>以/結尾，則URL指定的文件將被直接下載並保存為<dest>/<filename>；如果<src>是一個本地系統上的壓縮格式的tar文件，它將被展開為一個目錄，其行為類似於“tar -x”命令；然而，通過URL獲取到的tar文件將不會自動展開；如果<src>有多個，或其間接或直接使用了通配符，則<dest>必須是一個以/結尾的目錄路徑；如果<dest>不以/結尾，則其被視作一個普通文件，<src>的內容將被直接寫入到<dest>；

　　示例：

[root@node1 test]# ls
Dockerfile  html  nginx-1.19.0.tar.gz  test.html
[root@node1 test]# cat Dockerfile 
FROM busybox:latest

MAINTAINER "qiuhom <qiuhom@linux-1874.com>"

LABEL version="1.0"

LABEL description="this is test file \ that label-values can span multiple lines."

COPY html /var/www/html/

COPY test.html /tmp/

ADD http://nginx.org/download/nginx-1.18.0.tar.gz /usr/src/

ADD nginx-1.19.0.tar.gz /tmp/
[root@node1 test]#

　　提示：以上Dokcerfile里指定把當前目錄下的nginx-1.19.0.tar.gz 添加到鏡像中的/tmp/下，並且會把nginx-1.19.0.tar.gz展開成一個目錄；而對於

ADD http://nginx.org/download/nginx-1.18.0.tar.gz /usr/src/這條指令它會把指定url的文件下載到/usr/src/，但是不會tar文件展開；

　　測試：把上面dockerfile編譯成鏡像，看看對應目錄中的文件是否都展開了？

[root@node1 test]# docker build . -t myimg:v0.2
Sending build context to Docker daemon   1.05MB
Step 1/8 : FROM busybox:latest
 ---> 78096d0a5478
Step 2/8 : MAINTAINER "qiuhom <qiuhom@linux-1874.com>"
 ---> Using cache
 ---> bf9b966a914b
Step 3/8 : LABEL version="1.0"
 ---> Using cache
 ---> 5dd2e4b3f594
Step 4/8 : LABEL description="this is test file \ that label-values can span multiple lines."
 ---> Using cache
 ---> 994f06ff65f8
Step 5/8 : COPY html /var/www/html/
 ---> Using cache
 ---> f2b46094d9a9
Step 6/8 : COPY test.html /tmp/
 ---> Using cache
 ---> c78c7188f804
Step 7/8 : ADD http://nginx.org/download/nginx-1.18.0.tar.gz /usr/src/
Downloading   1.04MB/1.04MB
 ---> 23f47a028853
Step 8/8 : ADD nginx-1.19.0.tar.gz /tmp/
 ---> 6ba2693b3084
Successfully built 6ba2693b3084
Successfully tagged myimg:v0.2
[root@node1 test]# docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
myimg               v0.2                6ba2693b3084        27 seconds ago      8.54MB
myimg               v0.1                c78c7188f804        25 minutes ago      1.22MB
busybox             latest              78096d0a5478        2 weeks ago         1.22MB
[root@node1 test]# docker run --name test --rm -it myimg:v0.2 /bin/sh
/ # ls /usr/src/
nginx-1.18.0.tar.gz
/ # ls /tmp
nginx-1.19.0  test.html
/ # exit
[root@node1 test]#

　　提示：從上面的信息可以看到，在容器中的/usr/src/目錄下nginx-1.18.0.tar.gz並沒有展開，而在/tmp/下卻把niginx-1.19.0.tar.gz展開為nginx-1.19.0;從build的過程來看，除開後面的ADD過程，其他過程都很快，並且明確告訴我們使用了cache，則意味着在本地倉庫中有的鏡像層，默認是共享的；

　　6、WORKDIR：該指令用於設定Dockerfile中所有的RUN、CMD、ENTRYPOINT、COPY和ADD指令的工作目錄；一個Dockerfile中可以多次使用WORKDIR來指定當前WORKDIR指令到下一個WORKDIR指令之間的指令的工作目錄；語法格式WORKDIR <dirpath>；在Dockerfile文件中，WORKDIR指令可出現多次，其路徑也可以為相對路徑，不過，其是相對此前一個WORKDIR指令指定的路徑，另外，WORKDIR也可調用由ENV指定定義的變量；

　　示例：

[root@node1 test]# cat Dockerfile 
FROM busybox:latest

MAINTAINER "qiuhom <qiuhom@linux-1874.com>"

LABEL version="1.0"

LABEL description="this is test file \ that label-values can span multiple lines."

WORKDIR /var/www/

COPY html html/

COPY test.html /tmp/

WORKDIR /usr/

ADD http://nginx.org/download/nginx-1.18.0.tar.gz src/

ADD nginx-1.19.0.tar.gz /tmp/
[root@node1 test]#

　　提示：我們在dockerfile中指定了workdir的路徑后，其後的指令就可以以上一個workdir指定的路徑 為基準後面使用相對路徑；

　　測試：製作鏡像運行容器，看看是否把對應文件都添加到容器的指定目錄里？

[root@node1 test]# cat Dockerfile 
FROM busybox:latest

MAINTAINER "qiuhom <qiuhom@linux-1874.com>"

LABEL version="1.0"

LABEL description="this is test file \ that label-values can span multiple lines."

WORKDIR /var/www/

COPY html html/

COPY test.html /tmp/

WORKDIR /usr/

ADD http://nginx.org/download/nginx-1.18.0.tar.gz src/

ADD nginx-1.19.0.tar.gz /tmp/
[root@node1 test]# 
[root@node1 test]# docker build . -t myimg:v0.3
Sending build context to Docker daemon   1.05MB
Step 1/10 : FROM busybox:latest
 ---> 78096d0a5478
Step 2/10 : MAINTAINER "qiuhom <qiuhom@linux-1874.com>"
 ---> Using cache
 ---> bf9b966a914b
Step 3/10 : LABEL version="1.0"
 ---> Using cache
 ---> 5dd2e4b3f594
Step 4/10 : LABEL description="this is test file \ that label-values can span multiple lines."
 ---> Using cache
 ---> 994f06ff65f8
Step 5/10 : WORKDIR /var/www/
 ---> Running in 623002a4c418
Removing intermediate container 623002a4c418
 ---> 7e6898b36dd5
Step 6/10 : COPY html html/
 ---> 57ff5a48a104
Step 7/10 : COPY test.html /tmp/
 ---> f66a1bf4040a
Step 8/10 : WORKDIR /usr/
 ---> Running in b905ff1b4529
Removing intermediate container b905ff1b4529
 ---> 1fdceb9a6bfd
Step 9/10 : ADD http://nginx.org/download/nginx-1.18.0.tar.gz src/
Downloading   1.04MB/1.04MB
 ---> 92868df29f5b
Step 10/10 : ADD nginx-1.19.0.tar.gz /tmp/
 ---> 68161c3beb90
Successfully built 68161c3beb90
Successfully tagged myimg:v0.3
[root@node1 test]# docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
myimg               v0.3                68161c3beb90        11 seconds ago      8.54MB
myimg               v0.2                6ba2693b3084        18 minutes ago      8.54MB
myimg               v0.1                c78c7188f804        43 minutes ago      1.22MB
busybox             latest              78096d0a5478        2 weeks ago         1.22MB
[root@node1 test]# docker run --name test --rm -it myimg:v0.3 /bin/sh
/usr # pwd
/usr
/usr # ls 
sbin  src
/usr # ls src/
nginx-1.18.0.tar.gz
/usr # ls /tmp/
nginx-1.19.0  test.html
/usr # ls /var/www/
html
/usr # exit
[root@node1 test]#

　　提示：可以看到我們製作的鏡像啟動為容器后，默認是我們指定的最後一個workdir的路徑；

※自行創業缺乏曝光? 網頁設計幫您第一時間規劃公司的形象門面

網站的第一印象網頁設計，決定了客戶是否繼續瀏覽的意願。台北網動廣告製作的RWD網頁設計，採用精簡與質感的CSS語法，提升企業的專業形象與簡約舒適的瀏覽體驗，讓瀏覽者第一眼就愛上它。

　　示例：使用環境變量指定workdi的路徑；

[root@node1 test]# cat Dockerfile 
FROM busybox:latest

MAINTAINER "qiuhom <qiuhom@linux-1874.com>"

LABEL version="1.0"

LABEL description="this is test file \ that label-values can span multiple lines."

ENV webhome="/var/www/" src_home="/usr/"


WORKDIR $webhome

COPY html html/

COPY test.html /tmp/

WORKDIR $src_home

ADD http://nginx.org/download/nginx-1.18.0.tar.gz src/

ADD nginx-1.19.0.tar.gz /tmp/
[root@node1 test]#

　　提示：我們在原有的Dockerfile中添加了ENV webhome=”/var/www/” src_home=”/usr/” 表示添加兩個環境變量，而這兩個環境的變量的值分別是“/var/www/” 和“/usr” 這樣一來，在後面workdir引用該環境變量時 就會把對應的值給替換過去；dockerfile中變量引用同shell中的變量引用一樣都是使用$符合引用變量；

　　測試：利用上面的Dockerfile編譯成鏡像，然後運行成容器，看看我們在dockerfile中定義的環境變量是否能夠被容器所引用？

[root@node1 test]# docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
myimg               v0.3                68161c3beb90        34 minutes ago      8.54MB
myimg               v0.2                6ba2693b3084        53 minutes ago      8.54MB
myimg               v0.1                c78c7188f804        About an hour ago   1.22MB
busybox             latest              78096d0a5478        2 weeks ago         1.22MB
[root@node1 test]# docker build . -t myimg:v0.4
Sending build context to Docker daemon   1.05MB
Step 1/11 : FROM busybox:latest
 ---> 78096d0a5478
Step 2/11 : MAINTAINER "qiuhom <qiuhom@linux-1874.com>"
 ---> Using cache
 ---> bf9b966a914b
Step 3/11 : LABEL version="1.0"
 ---> Using cache
 ---> 5dd2e4b3f594
Step 4/11 : LABEL description="this is test file \ that label-values can span multiple lines."
 ---> Using cache
 ---> 994f06ff65f8
Step 5/11 : ENV webhome="/var/www/" src_home="/usr/"
 ---> Running in 82738c50a595
Removing intermediate container 82738c50a595
 ---> 9f089c14778f
Step 6/11 : WORKDIR $webhome
 ---> Running in 3e9d7d4276bf
Removing intermediate container 3e9d7d4276bf
 ---> 94e17268d7ea
Step 7/11 : COPY html html/
 ---> cf3be18998db
Step 8/11 : COPY test.html /tmp/
 ---> 3b81cb058412
Step 9/11 : WORKDIR $src_home
 ---> Running in 70478cb9d405
Removing intermediate container 70478cb9d405
 ---> e0d8ab9331f4
Step 10/11 : ADD http://nginx.org/download/nginx-1.18.0.tar.gz src/
Downloading   1.04MB/1.04MB
 ---> b4e546989783
Step 11/11 : ADD nginx-1.19.0.tar.gz /tmp/
 ---> df3d040b5766
Successfully built df3d040b5766
Successfully tagged myimg:v0.4
[root@node1 test]# docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
myimg               v0.4                df3d040b5766        4 minutes ago       8.54MB
myimg               v0.3                68161c3beb90        41 minutes ago      8.54MB
myimg               v0.2                6ba2693b3084        59 minutes ago      8.54MB
myimg               v0.1                c78c7188f804        About an hour ago   1.22MB
busybox             latest              78096d0a5478        2 weeks ago         1.22MB
[root@node1 test]# docker run --name test --rm -it myimg:v0.4 /bin/sh
/usr # pwd
/usr
/usr # ls /var/www/
html
/usr # ls /usr/src/
nginx-1.18.0.tar.gz
/usr #

　　提示：可以看到我們指定的ENV環境變量是能夠被WORKDIR說引用

　　7、ENV：用於為鏡像定義所需的環境變量，並可被Dockerfile文件中位於其後的其它指令（如ENV、ADD、COPY等）所調用；調用格式為$variable_name或${variable_name}；語法格式ENV <key> <value> 或 ENV <key>=<value> …；第一種格式中，<key>之後的所有內容均會被視作其<value>的組成部分，因此，一次只能設置一個變量；第二種格式可用一次設置多個變量，每個變量為一個”<key>=<value>”的鍵值對，如果<value>中包含空格，可以以反斜線(\)進行轉義，也可通過對<value>加引號進行標識；另外，反斜線也可用於續行；定義多個變量時，建議使用第二種方式，以便在同一層中完成所有功能；

　　示例：

[root@node1 test]# cat Dockerfile 
FROM busybox:latest

MAINTAINER "qiuhom <qiuhom@linux-1874.com>"

LABEL version="1.0"

LABEL description="this is test file \ that label-values can span multiple lines."

ENV web_home="/var/www/html/"

COPY html ${web_home}


[root@node1 test]#

　　提示：上面Dockerfile設置了環境變量web_home=”/var/www/html” ，後面的COPY引用時直接使用${web_home}即可；COPY html ${web_home}表示把html目錄中的文件複製到web_home這個變量所指定的目錄中，即/var/www/html/;

　　測試：編譯成鏡像，看看是否把對應html目錄下的文件複製到/var/www/html/目錄下了？

[root@node1 test]# docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
myimg               v0.4                df3d040b5766        17 minutes ago      8.54MB
myimg               v0.3                68161c3beb90        54 minutes ago      8.54MB
myimg               v0.2                6ba2693b3084        About an hour ago   8.54MB
myimg               v0.1                c78c7188f804        2 hours ago         1.22MB
busybox             latest              78096d0a5478        2 weeks ago         1.22MB
[root@node1 test]# docker build . -t myimg:v0.5
Sending build context to Docker daemon   1.05MB
Step 1/6 : FROM busybox:latest
 ---> 78096d0a5478
Step 2/6 : MAINTAINER "qiuhom <qiuhom@linux-1874.com>"
 ---> Using cache
 ---> bf9b966a914b
Step 3/6 : LABEL version="1.0"
 ---> Using cache
 ---> 5dd2e4b3f594
Step 4/6 : LABEL description="this is test file \ that label-values can span multiple lines."
 ---> Using cache
 ---> 994f06ff65f8
Step 5/6 : ENV web_home="/var/www/html/"
 ---> Running in 4c136d790dd0
Removing intermediate container 4c136d790dd0
 ---> 90e193e4e810
Step 6/6 : COPY html ${web_home}
 ---> e21e9479b0a7
Successfully built e21e9479b0a7
Successfully tagged myimg:v0.5
[root@node1 test]# docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
myimg               v0.5                e21e9479b0a7        4 seconds ago       1.22MB
myimg               v0.4                df3d040b5766        17 minutes ago      8.54MB
myimg               v0.3                68161c3beb90        54 minutes ago      8.54MB
myimg               v0.2                6ba2693b3084        About an hour ago   8.54MB
myimg               v0.1                c78c7188f804        2 hours ago         1.22MB
busybox             latest              78096d0a5478        2 weeks ago         1.22MB
[root@node1 test]# docker run --name test --rm -it myimg:v0.5 /bin/sh
/ # ls /var/www/html/
test1.html  test2.html
/ # exit
[root@node1 test]#

　　提示：可以看到我們打包的鏡像運行成容器后，ENV指定的環境變量目錄里有html目錄下的所有文件；

　　8、ARG：該指令用於編譯階段可以使用docker build –build-arg向dockerfile里ARG 指定的變量傳遞值；語法格式ARG <name>[=<default value>]；該指令可以在dockerfile中使用多次，也可以給定默認變量一個默認的值，在用戶沒有向該變量傳遞值的情況；

　　示例：

[root@node1 test]# cat Dockerfile 
FROM busybox:latest

MAINTAINER "qiuhom <qiuhom@linux-1874.com>"

LABEL version="1.0"

LABEL description="this is test file \ that label-values can span multiple lines."

ARG web_home="/var/www/html/"

COPY html ${web_home}


[root@node1 test]#

　　提示：以上Dockerfile 指定了web_home變量的默認值是“/var/www/html/” 如果在我們build階段沒有使用–build-arg來向web_home傳遞值時，它默認就是“/var/www/html/”，如果我們使用了 –build-agr 指定web_home的值后，後面引用web_home變量的值就是我們用–build-arg傳遞給它的值；

　　測試：使用–build-arg向web_home傳遞值

[root@node1 test]# docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
myimg               v0.5                e21e9479b0a7        14 minutes ago      1.22MB
myimg               v0.4                df3d040b5766        31 minutes ago      8.54MB
myimg               v0.3                68161c3beb90        About an hour ago   8.54MB
myimg               v0.2                6ba2693b3084        About an hour ago   8.54MB
myimg               v0.1                c78c7188f804        2 hours ago         1.22MB
busybox             latest              78096d0a5478        2 weeks ago         1.22MB
[root@node1 test]# docker build . --build-arg web_home="/usr/share/www/html/" -t myimg:v0.6
Sending build context to Docker daemon   1.05MB
Step 1/6 : FROM busybox:latest
 ---> 78096d0a5478
Step 2/6 : MAINTAINER "qiuhom <qiuhom@linux-1874.com>"
 ---> Using cache
 ---> bf9b966a914b
Step 3/6 : LABEL version="1.0"
 ---> Using cache
 ---> 5dd2e4b3f594
Step 4/6 : LABEL description="this is test file \ that label-values can span multiple lines."
 ---> Using cache
 ---> 994f06ff65f8
Step 5/6 : ARG web_home="/var/www/html/"
 ---> Running in d8697abf9206
Removing intermediate container d8697abf9206
 ---> 6abb65dab341
Step 6/6 : COPY html ${web_home}
 ---> 385cba27c288
Successfully built 385cba27c288
Successfully tagged myimg:v0.6
[root@node1 test]# docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
myimg               v0.6                385cba27c288        6 seconds ago       1.22MB
myimg               v0.5                e21e9479b0a7        15 minutes ago      1.22MB
myimg               v0.4                df3d040b5766        32 minutes ago      8.54MB
myimg               v0.3                68161c3beb90        About an hour ago   8.54MB
myimg               v0.2                6ba2693b3084        About an hour ago   8.54MB
myimg               v0.1                c78c7188f804        2 hours ago         1.22MB
busybox             latest              78096d0a5478        2 weeks ago         1.22MB
[root@node1 test]# docker run --name test --rm -it myimg:v0.6 /bin/sh
/ # ls /usr/share/www/html/
test1.html  test2.html
/ # exit
[root@node1 test]#

　　提示：可以看到我們傳遞進去的路徑下有html目錄下的兩個網頁文件；這說明通過–build-arg 選項可以向Dockerfile里ARG指定指定的變量傳遞值的；

　　示例：引用變量給定變量默認值

[root@node1 test]# cat Dockerfile 
FROM busybox:latest

MAINTAINER "qiuhom <qiuhom@linux-1874.com>"

LABEL version="1.0"

LABEL description="this is test file \ that label-values can span multiple lines."

ARG web_home

COPY html ${web_home:-"/data/htdoc/"}


[root@node1 test]#

　　提示：引用變量給定變量默認值的方式同shell中的用法一樣；${web_home:-“/data/htdoc/”} 表示如果web_home這個變量的值未設定或者為空時，就使用默認的值“/data/htdoc/”這個值，如果設置了，那麼設置的是什麼值就是什麼值；

　　測試：不使用–build-arg向web_home傳遞值，看看web_home是否會拿到默認值？

[root@node1 test]# docker build . -t myimg:v0.7
Sending build context to Docker daemon   1.05MB
Step 1/6 : FROM busybox:latest
 ---> 78096d0a5478
Step 2/6 : MAINTAINER "qiuhom <qiuhom@linux-1874.com>"
 ---> Using cache
 ---> bf9b966a914b
Step 3/6 : LABEL version="1.0"
 ---> Using cache
 ---> 5dd2e4b3f594
Step 4/6 : LABEL description="this is test file \ that label-values can span multiple lines."
 ---> Using cache
 ---> 994f06ff65f8
Step 5/6 : ARG web_home
 ---> Running in 9d98f8e3a1f0
Removing intermediate container 9d98f8e3a1f0
 ---> f164cc3e24ad
Step 6/6 : COPY html ${web_home:-"/data/htdoc/"}
 ---> 4bedea2590b7
Successfully built 4bedea2590b7
Successfully tagged myimg:v0.7
[root@node1 test]# docker run --name test --rm -it myimg:v0.7 /bin/sh
/ # ls /
bin   data  dev   etc   home  proc  root  sys   tmp   usr   var
/ # ls /data/
htdoc
/ # ls /data/htdoc/
test1.html  test2.html
/ # exit
[root@node1 test]#

　　提示：可以看到不想web_home傳遞值，默認就是使用我們給設定的默認值

　　測試：向web_home傳遞值，看看是否還會使用默認值呢？

[root@node1 test]# docker build . --build-arg web_home=/web/html/ -t myimg:v0.9
Sending build context to Docker daemon   1.05MB
Step 1/6 : FROM busybox:latest
 ---> 78096d0a5478
Step 2/6 : MAINTAINER "qiuhom <qiuhom@linux-1874.com>"
 ---> Using cache
 ---> bf9b966a914b
Step 3/6 : LABEL version="1.0"
 ---> Using cache
 ---> 5dd2e4b3f594
Step 4/6 : LABEL description="this is test file \ that label-values can span multiple lines."
 ---> Using cache
 ---> 994f06ff65f8
Step 5/6 : ARG web_home
 ---> Using cache
 ---> f164cc3e24ad
Step 6/6 : COPY html ${web_home:-"/data/htdoc/"}
 ---> 4b6993911e6d
Successfully built 4b6993911e6d
Successfully tagged myimg:v0.9
[root@node1 test]# docker run --name test --rm -it myimg:v0.9 /bin/sh          
/ # ls /
bin   dev   etc   home  proc  root  sys   tmp   usr   var   web
/ # ls /web/
html
/ # ls /web/html/
test1.html  test2.html
/ # exit
[root@node1 test]#

　　提示：可以看到通過–build-arg傳遞了web_home的值為“/web/htm/”后，默認的“/data/htdoc/”的值就不會生效；

　　9、VOLUME：用於在image中創建一個掛載點目錄，以掛載Docker host上的卷或其它容器上的卷；語法格式 VOLUME <mountpoint> 或 VOLUME [“<mountpoint>”]；如果掛載點目錄路徑下此前的文件存在，docker run命令會在卷掛載完成后將此前的所有文件複製到新掛載的卷中；

　　示例：

[root@node1 test]# cat Dockerfile
FROM busybox:latest

MAINTAINER "qiuhom <qiuhom@linux-1874.com>"

LABEL version="1.0"

LABEL description="this is test file \ that label-values can span multiple lines."

ARG web_home

COPY html ${web_home:-"/data/htdoc/"}

VOLUME ${web_home:-"/data/htdoc/"}


[root@node1 test]#

　　提示：volume是指定鏡像里的掛載點，如果該掛載點裏面原來是有文件存在，在使用docker run 時，用-v指定把宿主機上的某個目錄掛載到該掛載點時，默認會把原來有的文件複製新掛載的卷中；這裏還需要特被說一下，這裏指定卷是在鏡像內部創建一個掛載點，運行成容器還需要我們手動的用-v去指定把那個目錄掛載到該掛載點，如果不指定默認就是docker-managed 類型的卷；

　　測試：編譯成鏡像，然後運行成容器，看看我們指定的卷宗的文件會不會被覆蓋掉？是否會有文件存在？

[root@node1 test]# docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
myimg               v0.9                4b6993911e6d        21 minutes ago      1.22MB
myimg               v0.7                4bedea2590b7        23 minutes ago      1.22MB
myimg               v0.6                385cba27c288        30 minutes ago      1.22MB
myimg               v0.5                e21e9479b0a7        46 minutes ago      1.22MB
myimg               v0.4                df3d040b5766        About an hour ago   8.54MB
myimg               v0.3                68161c3beb90        2 hours ago         8.54MB
myimg               v0.2                6ba2693b3084        2 hours ago         8.54MB
myimg               v0.1                c78c7188f804        2 hours ago         1.22MB
busybox             latest              78096d0a5478        2 weeks ago         1.22MB
[root@node1 test]# docker build . -t myimg:v1.0
Sending build context to Docker daemon   1.05MB
Step 1/7 : FROM busybox:latest
 ---> 78096d0a5478
Step 2/7 : MAINTAINER "qiuhom <qiuhom@linux-1874.com>"
 ---> Using cache
 ---> bf9b966a914b
Step 3/7 : LABEL version="1.0"
 ---> Using cache
 ---> 5dd2e4b3f594
Step 4/7 : LABEL description="this is test file \ that label-values can span multiple lines."
 ---> Using cache
 ---> 994f06ff65f8
Step 5/7 : ARG web_home
 ---> Using cache
 ---> f164cc3e24ad
Step 6/7 : COPY html ${web_home:-"/data/htdoc/"}
 ---> Using cache
 ---> 4bedea2590b7
Step 7/7 : VOLUME ${web_home:-"/data/htdoc/"}
 ---> Running in 34cad9ca1f79
Removing intermediate container 34cad9ca1f79
 ---> 9554284e4bba
Successfully built 9554284e4bba
Successfully tagged myimg:v1.0
[root@node1 test]# docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
myimg               v1.0                9554284e4bba        2 minutes ago       1.22MB
myimg               v0.9                4b6993911e6d        24 minutes ago      1.22MB
myimg               v0.7                4bedea2590b7        26 minutes ago      1.22MB
myimg               v0.6                385cba27c288        33 minutes ago      1.22MB
myimg               v0.5                e21e9479b0a7        49 minutes ago      1.22MB
myimg               v0.4                df3d040b5766        About an hour ago   8.54MB
myimg               v0.3                68161c3beb90        2 hours ago         8.54MB
myimg               v0.2                6ba2693b3084        2 hours ago         8.54MB
myimg               v0.1                c78c7188f804        2 hours ago         1.22MB
busybox             latest              78096d0a5478        2 weeks ago         1.22MB
[root@node1 test]# docker run --name test --rm -it myimg:v1.0 /bin/sh
/ # ls /
bin   data  dev   etc   home  proc  root  sys   tmp   usr   var
/ # ls /data/htdoc/
test1.html  test2.html
/ # [root@node1 test]# 
[root@node1 test]# docker container inspect test -f {{.Mounts}}
[{volume f3409b021267bd27d58c4b16fb1bc0dae77d4f92f7b5e6255f4ed26a6c27e459 /var/lib/docker/volumes/f3409b021267bd27d58c4b16fb1bc0dae77d4f92f7b5e6255f4ed26a6c27e459/_data /data/htdoc local  true }]
[root@node1 test]# ll /var/lib/docker/volumes/f3409b021267bd27d58c4b16fb1bc0dae77d4f92f7b5e6255f4ed26a6c27e459/_data
total 8
-rw-r--r-- 1 root root 19 May 31 01:51 test1.html
-rw-r--r-- 1 root root 19 May 31 01:51 test2.html
[root@node1 test]#

　　提示：可以看到運行成容器后，默認會把我們指定卷掛載成docker-managed類型的卷；同時我們也看到了對應掛載點上目錄會把原有文件複製到現volume中；

　　測試：手動指定宿主機目錄掛載到掛載點，文件是否還會存在呢？

[root@node1 ~]# mkdir /work
[root@node1 ~]# docker run --name test1 --rm -it -v /work:/data/htdoc/ myimg:v1.0 /bin/sh 
/ # ls /data/htdoc/
/ # [root@node1 ~]# ls /work/
[root@node1 ~]#

　　提示：手動指定掛載關係，它就不會把原有目錄下的文件複製到現掛載目錄中了；也就是說，人為手動指定掛載關係，宿主機上的的目錄會覆蓋容器內掛載點下的文件；只有docker自身管理的掛載的卷才會把原目錄下的文件複製到現掛載目錄里；

　　10、EXPOSE：用於為容器打開指定要監聽的端口以實現與外部通信（暴露端口）；語法格式 EXPOSE <port>[/<protocol>] [<port>[/<protocol>] …]； <protocol>用於指定傳輸層協議，可為tcp或udp二者之一，默認為TCP協議；EXPOSE指令可一次指定多個端口；

　　示例：

[root@node1 test]# cat Dockerfile 
FROM busybox:latest

MAINTAINER "qiuhom <qiuhom@linux-1874.com>"

LABEL version="1.0"

LABEL description="this is test file \ that label-values can span multiple lines."

ARG web_home

COPY html ${web_home:-"/data/htdoc/"}

VOLUME ${web_home:-"/data/htdoc/"}

EXPOSE 80/tcp 443/tcp


[root@node1 test]#

　　提示：以上dockerfile中暴露了tcp的80和443端口；在dockerfile中使用EXPOSE暴露端口，在運行成容器時，如果不使用-P來暴露端口，容器里的端口還是暴露不出來；這裏只是build階段明確說明要暴露80和443，而運行成容器我們需要使用-P來把build暴露的端口暴露出來；

　　測試：運行時不使用-P暴露端口，看看是否能夠把80和443暴露出來呢？

[root@node1 test]# docker build . -t myimg:v1.1
Sending build context to Docker daemon   1.05MB
Step 1/8 : FROM busybox:latest
 ---> 78096d0a5478
Step 2/8 : MAINTAINER "qiuhom <qiuhom@linux-1874.com>"
 ---> Using cache
 ---> bf9b966a914b
Step 3/8 : LABEL version="1.0"
 ---> Using cache
 ---> 5dd2e4b3f594
Step 4/8 : LABEL description="this is test file \ that label-values can span multiple lines."
 ---> Using cache
 ---> 994f06ff65f8
Step 5/8 : ARG web_home
 ---> Using cache
 ---> f164cc3e24ad
Step 6/8 : COPY html ${web_home:-"/data/htdoc/"}
 ---> Using cache
 ---> 4bedea2590b7
Step 7/8 : VOLUME ${web_home:-"/data/htdoc/"}
 ---> Using cache
 ---> 9554284e4bba
Step 8/8 : EXPOSE 80/tcp 443/tcp
 ---> Running in 8d7d5b4aab94
Removing intermediate container 8d7d5b4aab94
 ---> 79c118ea9eb3
Successfully built 79c118ea9eb3
Successfully tagged myimg:v1.1
[root@node1 test]# docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
myimg               v1.1                79c118ea9eb3        4 seconds ago       1.22MB
myimg               v1.0                9554284e4bba        24 minutes ago      1.22MB
myimg               v0.9                4b6993911e6d        46 minutes ago      1.22MB
myimg               v0.7                4bedea2590b7        48 minutes ago      1.22MB
myimg               v0.6                385cba27c288        55 minutes ago      1.22MB
myimg               v0.5                e21e9479b0a7        About an hour ago   1.22MB
myimg               v0.4                df3d040b5766        About an hour ago   8.54MB
myimg               v0.3                68161c3beb90        2 hours ago         8.54MB
myimg               v0.2                6ba2693b3084        2 hours ago         8.54MB
myimg               v0.1                c78c7188f804        3 hours ago         1.22MB
busybox             latest              78096d0a5478        2 weeks ago         1.22MB
[root@node1 test]# docker run --name test --rm -it myimg:v1.0 /bin/sh                        
/ # [root@node1 test]# docker ps -a
CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
ca4cea9a6f58        myimg:v1.0          "/bin/sh"           15 seconds ago      Up 15 seconds                           test
[root@node1 test]# docker container port test
[root@node1 test]#

　　提示：可以看到運行時，我們不使用-P來暴露端口是把容器內部端口暴露不出來的；

　　示例：使用-P來暴露dockerfile里定義的端口

[root@node1 test]# docker run --name test --rm -it -P myimg:v1.1 /bin/sh
/ # [root@node1 test]# docker container port test
443/tcp -> 0.0.0.0:32768
80/tcp -> 0.0.0.0:32769
[root@node1 test]# docker ps -a
CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS                                           NAMES
a78f6cebc0de        myimg:v1.1          "/bin/sh"           19 seconds ago      Up 19 seconds       0.0.0.0:32769->80/tcp, 0.0.0.0:32768->443/tcp   test
[root@node1 test]#

　　提示：可以看到使用-P就可以在運行時把build階段定義的暴露端口全部給暴露出來；

本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理

※如何讓商品強力曝光呢? 網頁設計公司幫您建置最吸引人的網站，提高曝光率!

以設計的實用美學觀點，規劃出舒適、美觀的視覺畫面，有效提昇使用者的心理期待，營造出輕鬆、愉悅的網站瀏覽體驗。

Cypress系列（3）- Cypress 的初次體驗_台北網頁設計

發佈日期: 作者:

※廣告預算用在刀口上，台北網頁設計公司幫您達到更多曝光效益

擁有後台管理系統的網站，將擁有強大的資料管理與更新功能，幫助您隨時新增網站的內容並節省網站開發的成本。

如果想從頭學起Cypress，可以看下面的系列文章哦

https://www.cnblogs.com/poloyy/category/1768839.html

 

前言

這裏的栗子項目是 Cypress 提供的，在 github 上，所以要 clone 到本地的話需要裝 Git 哦！

 

下載被測應用

進入要安裝該應用的目錄，cmd 敲

git clone git@github.com:cypress-io/cypress-example-recipes.git

進入項目目錄下，安裝項目所需依賴包，敲

npm install

安裝成功后，項目的文件結構如下圖；所有被測應用栗子都在 examples 文件夾中

 

啟動被測應用

啟動測試應用時，可以進入不同子項目文件夾來啟動不同的應用；

假如，我們要測試表單類型的登錄，可以打開以下被測應用

cd examples\logging-in__html-web-forms>

 

啟動本地server

npm start

 

啟動成功后，cmd窗口將显示服務器的地址和端口

 

打開瀏覽器訪問：http://localhost:7077/，即可看到登錄頁面

 

快速測試登錄頁面

首先，設計測試用例步驟

  1. 訪問http://localhost:7077
  2. 輸入用戶名、密碼，點擊登錄
  3. 如果用戶名和密碼正確，則登錄成功，否則登錄失敗

 

接下來，我們來看看實現測試用例的步驟

 

創建測試

在此目錄下 cypress安裝路徑\node_modules\.bin\cypress\integration ，創建一個 js 文件，比如：testLogin.js

integration文件夾

  • Cypress 安裝完畢后自動生成的文件夾
  • 也是 Cypress 默認存放測試用例的根目錄，任何創建在此目錄下的文件都將被當作測試用例

 

編寫測試用例

首先，要在網頁上定位到用戶名、密碼輸入框，此案例中使用標籤+屬性名來定位；最終測試代碼如下

咱們在後面再講解代碼的意思哦

 

運行測試

進入 Cypress 安裝文件夾，cmd執行命令

yarn cypress:open

 

單擊 testLogin.js，Cypress 會啟動 Test  Runner 運行測試，運行成功后，將看到運行結果頁面；運行時長是真的快….

※廣告預算用在刀口上，台北網頁設計公司幫您達到更多曝光效益

擁有後台管理系統的網站，將擁有強大的資料管理與更新功能，幫助您隨時新增網站的內容並節省網站開發的成本。

 

調試測試用例

前言

  • 測試用例運行時，難免會發生各種情況導致運行失敗；快速定位發生錯誤的位置，了解錯誤信息，一直是自動化測試的痛點
  • 而 Cypress 提供了多種 debug 能力，可以在測試運行錯誤時直達錯誤位置，並支持回放錯誤發生時的上下文信息，可直接看到測試失敗的原因 

 

Cypress Debug 能力介紹

每個命令均有快照且支持回放

像下圖，左側就是測試步驟，右側是測試頁面

  • 鼠標 hover 測試步驟，在右側可以看到執行該命令時的頁面效果
  • 鼠標點擊測試步驟，可以鎖定該步驟，然後查看上下文信息

 

支持查看測試運行時發生的特殊頁面事件

包括：

  • 網絡 XHR 請求
  • URL 哈希更改
  • 頁面加載
  • 表單提交

例如，上面測試用例中，點擊【submit】后產生的就是提交表單的請求，看下圖

可以看到一個 submit 操作，分成了三步走

  1. form sub：提交表單
  2. page load：頁面加載
  3. new url：訪問新的頁面

 

Console 輸出每個命令的詳細信息

瀏覽器F12即可見到熟悉的開發者工具頁面了

以上圖為栗子，一個 submitting form 表單提交的請求，在 Console 中打印了詳細的信息，可以快速了解在運行時的詳細狀態信息

 

暫停測試並逐步運行、恢復執行

在調試測試代碼時，Cypress 提供了兩個命令來暫停測試運行

  1. cy.pause()
  2. cy.debug()

 

cy.pause() 的栗子

在表單提交之前暫停測試，我們來看看運行結果

左上角有兩個按鈕，從左往右分別是

  • Resume：繼續執行測試用例並運行到結束
  • Next:get：測試會變成逐步運行，點一下執行下一個命令

 

cy.debug() 的栗子

運行測試看看下圖結果

測試運行在找到表單的時候，暫停運行並等待用戶操作

頂部的Paused in debugger，右邊兩個按鈕分別是
  • Resume Script Execution（F8）：繼續執行測試用例並運行到結束
  • Step Over next function call（F10）：跳轉到下一個調用debug()函數的地方 

 

當找到隱藏或多個元素時，可視化結果

更改 username 輸入框的定位器，使他匹配到不止一個元素

運行測試看看下面結果

因為定位表達式匹配到不止一個元素，所以執行 type() 方法時以失敗告終

 

總結

這一節咱們以測試一個登錄界面為需求，寫了一個簡單的測試用例來做栗子，後面將詳細講解 Cypress 的各部分內容哦

 

本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理

※廣告預算用在刀口上，台北網頁設計公司幫您達到更多曝光效益

擁有後台管理系統的網站，將擁有強大的資料管理與更新功能，幫助您隨時新增網站的內容並節省網站開發的成本。

一個工業級、跨平台、輕量級的 tcp 網絡服務框架：gevent_網頁設計公司

發佈日期: 作者:

※想知道最厲害的網頁設計公司嚨底家"!

RWD（響應式網頁設計）是透過瀏覽器的解析度來判斷要給使用者看到的樣貌

作為公司的公共產品，經常有這樣的需求：就是新建一個本地服務，產品線作為客戶端通過 tcp 接入本地服務，來獲取想要的業務能力。

與印象中動輒處理成千上萬連接的 tcp 網絡服務不同，這個本地服務是跑在客戶機器上的，Win32 上作為開機自啟動的 windows 服務運行；

Linux 上作為 daemon 在後台運行。總的說來就是用於接收幾個產品進程的連接，因此輕量化是其最重要的要求，在這個基礎上要能兼顧跨平台就可以了。

其實主要就是 windows，再兼顧一點兒 linux。

 

考察了幾個現有的開源網絡框架，從 ACE 、boost::asio 到 libevent，都有不盡於人意的地方：

a) ACE：太重，只是想要一個網絡框架，結果它扒拉扒拉一堆全提供了，不用還不行；

b) boost::asio：太複雜，牽扯到 boost 庫，並且引入了一堆 c++ 模板，需要高版本 c++ 編譯器支持；

c) libevent：這個看着不錯，當時確實用這個做底層封裝了一版，結果發版后發現一個比較致命的問題，導致在防火牆設置比較嚴格的機器上初始化失敗，這個後面我會詳細提到。

 

其它的就更不用說了，之前也粗略看過陳碩的 muddo，總的感覺吧，它是基於其它開源框架不足地方改進的一個庫，有相當可取的地方，但是這個改進的方向也主要是解決更大併發、更多連接，不是我的痛點，所以沒有繼續深入研究。

 

好了，與其在不同開源框架之間糾結，不如自己動手寫一個。

反正我的場景比較固定，不用像它們那樣面面俱，我給自己羅列了一些這個框架需要支持基本的功能：

1）同步寫、異步讀；

2）可同時監聽多路事件，基於 1）這裏只針對異步 READ 事件（包含連接進入、連接斷開），寫數據是同步的，因而不需要處理異步 WRITE 事件；

3）要有設置一次性和周期性定時器的能力 （業務決定的）；

4）不需要處理信號 （windows 上也沒信號這一說，linux 自己搞搞 sigaction 就好啦）；

……

 

雖然這個框架未來只會運行在用戶的單機上，但是我不希望它一出生就帶有性能缺陷，所以性能平平的 select 沒能進入我的法眼，我決定給它裝上最強大的心臟：

Windows 平台： iocp

Linux 平台：epoll

 

ok，從需求到底層技術路線，貌似都講清楚了，依照 libevent 我給它取名為 gevent，下面我們從代碼級別看下這個框架是怎麼簡化 tcp 服務搭建這類工作的。

首先看一下這個 tcp 服務框架的 sample：

svc_handler.h

 1 #include "EventBase.h"
 2 #include "EventHandler.h"
 3 
 4 class GMyEventBase : public GEventBase
 5 {
 6 public:
 7     GEventHandler* create_handler (); 
 8 }; 
 9 
10 
11 class svc_handler : public GJsonEventHandler
12 {
13 public:
14     virtual ~svc_handler () {}
15     virtual void on_read_msg (Json::Value const& val); 
16 };

epoll_svc.cpp

 1 #include <stdio.h>
 2 #include "svc_handler.h"
 3 #include <signal.h>
 4 
 5 GMyEventBase g_base; 
 6 GEventHandler* GMyEventBase::create_handler () 
 7 {
 8     return new svc_handler; 
 9 }
10 
11 void sig_int (int signo)
12 {
13     printf ("%d caught\n", signo); 
14     g_base.exit (1); 
15     printf ("exit ok\n"); 
16 }
17 
18 int main (int argc, char *argv[])
19 {
20     if (argc < 2)
21     {
22         printf ("usage: epoll_svc port\n"); 
23         return -1; 
24     }
25 
26     unsigned short port = atoi (argv[1]);
27 
28 #ifndef WIN32
29     struct sigaction act; 
30     act.sa_handler = sig_int; 
31     sigemptyset(&act.sa_mask);   
32     act.sa_flags = SA_RESTART; 
33     if (sigaction (SIGINT, &act, NULL) < 0)
34     {
35         printf ("install SIGINT failed, errno %d\n", errno); 
36         return -1; 
37     }
38     else
39         printf ("install SIGINT ok\n"); 
40 #endif
41 
42     // to test small message block
43     if (g_base.init (/*8, 10*/) < 0)
44         return -1; 
45 
46     printf ("init ok\n"); 
47     do
48     {
49         if (!g_base.listen (port))
50         {
51             g_base.exit (0); 
52             printf ("exit ok\n"); 
53             break; 
54         }
55 
56         printf ("listen ok\n"); 
57         g_base.run (); 
58         printf ("run  over\n"); 
59     } while (0); 
60 
61     g_base.fini (); 
62     printf ("fini ok\n"); 
63 
64     g_base.cleanup (); 
65     printf ("cleanup ok\n"); 
66     return 0; 
67 }

 

這個服務的核心是 GMyEventBase 類，它使用了框架中的 GEventBase 類，從後者派生而來，

只改寫了一個 create_handler 接口來提供我們的事件處理對象 svc_handler，它是從框架中的 GEventHandler 派生而來，

svc_handler 只改寫了一個 on_read_msg 來處理 Json 格式的消息輸入。

 

程序的運行就是分別調用 GMyEventBase（實際上是GEventBase）  的 init / listen / run / fini / cleaup 方法。

而與業務相關的代碼，都在 svc_handler 中處理：

svc_handler.cpp

 1 #include "svc_handler.h"
 2 
 3 void svc_handler::on_read_msg (Json::Value const& val)
 4 {
 5     int key = val["key"].asInt (); 
 6     std::string data = val["data"].asString (); 
 7     printf ("got %d:%s\n", key, data.c_str ()); 
 8 
 9     Json::Value root; 
10     Json::FastWriter writer; 
11     root["key"] = key + 1; 
12     root["data"] = data; 
13 
14     int ret = 0;
15     std::string resp = writer.write(root); 
16     resp = resp.substr (0, resp.length () - 1); // trim tailing \n
17     if ((ret = send (resp)) <= 0)
18         printf ("send response failed, errno %d\n", errno); 
19     else 
20         printf ("response %d\n", ret); 
21 }

 

它期待 Json 格式的數據，並且有兩個字段 key(int) 與 data (string)，接收數據后將 key 增 1 后返回給客戶端。

再來看下客戶端 sample：

clt_handler.h

 1 #include "EventBaseAR.h"
 2 #include "EventHandler.h"
 3 
 4 class GMyEventBase : public GEventBaseWithAutoReconnect
 5 {
 6 public:
 7     GEventHandler* create_handler (); 
 8 }; 
 9 
10 
11 class clt_handler : public GJsonEventHandler
12 {
13 public:
14     virtual ~clt_handler () {}
15 #ifdef TEST_TIMER
16     virtual bool on_timeout (GEV_PER_TIMER_DATA *gptd); 
17 #endif
18     virtual void on_read_msg (Json::Value const& val); 
19 };

 

epoll_clt.cpp

  1 #include <stdio.h>
  2 #include "clt_handler.h"
  3 #include <signal.h>
  4 
  5 //#define TEST_READ
  6 //#define TEST_CONN
  7 //#define TEST_TIMER
  8 
  9 GMyEventBase g_base; 
 10 GEventHandler* GMyEventBase::create_handler () 
 11 {
 12     return new clt_handler; 
 13 }
 14 
 15 
 16 int sig_caught = 0; 
 17 void sig_int (int signo)
 18 {
 19     sig_caught = 1; 
 20     printf ("%d caught\n", signo); 
 21     g_base.exit (0); 
 22     printf ("exit ok\n"); 
 23 }
 24 
 25 void do_read (GEventHandler *eh, int total)
 26 {
 27     char buf[1024] = { 0 }; 
 28     int ret = 0, n = 0, key = 0, err = 0;
 29     char *ptr = nullptr; 
 30     while ((total == 0 ||  n++ < total) && fgets (buf, sizeof(buf), stdin) != NULL)
 31     {
 32         // skip \n
 33         buf[strlen(buf) - 1] = 0; 
 34         //n = sscanf (buf, "%d", &key); 
 35         key = strtol (buf, &ptr, 10); 
 36         if (ptr == nullptr)
 37         {
 38             printf ("format: int string\n"); 
 39             continue; 
 40         }
 41 
 42         Json::Value root; 
 43         Json::FastWriter writer; 
 44         root["key"] = key; 
 45         // skip space internal
 46         root["data"] = *ptr == ' ' ? ptr + 1 : ptr;  
 47 
 48         std::string req = writer.write (root); 
 49         req = req.substr (0, req.length () - 1); // trim tailing \n
 50         if ((ret = eh->send (req)) <= 0)
 51         {
 52             err = 1; 
 53             printf ("send %d failed, errno %d\n", req.length (), errno); 
 54             break; 
 55         }
 56         else 
 57             printf ("send %d\n", ret); 
 58     }
 59 
 60     if (total == 0)
 61         printf ("reach end\n"); 
 62 
 63     if (!err)
 64     {
 65         eh->disconnect (); 
 66         printf ("call disconnect to notify server\n"); 
 67     }
 68 
 69     // wait receiving thread 
 70     //sleep (3); 
 71     // if use press Ctrl+D, need to notify peer our break
 72 }
 73 
 74 #ifdef TEST_TIMER
 75 void test_timer (unsigned short port, int period_msec, int times)
 76 {
 77     int n = 0; 
 78     GEventHandler *eh = nullptr; 
 79 
 80     do
 81     {
 82         eh = g_base.connect (port); 
 83         if (eh == nullptr)
 84             break;
 85 
 86         printf ("connect ok\n"); 
 87         void* t = g_base.timeout (1000, period_msec, eh, NULL); 
 88         if (t == NULL)
 89         {
 90             printf ("timeout failed\n"); 
 91             break; 
 92         }
 93         else 
 94             printf ("set timer %p ok\n", t); 
 95 
 96         // to wait timer
 97         do
 98         {
 99             sleep (400); 
100             printf ("wake up from sleep\n"); 
101         } while (!sig_caught && n++ < times);
102 
103         g_base.cancel_timer (t); 
104     } while (0); 
105 }
106 #endif
107 
108 #ifdef TEST_CONN
109 void test_conn (unsigned short port, int per_read, int times)
110 {
111 #  ifdef WIN32
112     srand (GetCurrentProcessId()); 
113 #  else
114     srand (getpid ()); 
115 #  endif
116     int n = 0, elapse = 0; 
117     clt_handler *eh = nullptr; 
118 
119     do
120     {
121         eh = (clt_handler *)g_base.connect (port); 
122         if (eh == nullptr)
123             break;
124 
125         printf ("connect ok\n"); 
126 
127         do_read (eh, per_read); 
128 #  ifdef WIN32
129         elapse = rand() % 1000; 
130         Sleep(elapse); 
131         printf ("running  %d ms\n", elapse); 
132 #  else
133         elapse = rand () % 1000000; 
134         usleep (elapse); 
135         printf ("running  %.3f ms\n", elapse/1000.0); 
136 #  endif
137 
138     } while (!sig_caught && n++ < times);
139 }
140 #endif
141 
142 #ifdef TEST_READ
143 void test_read (unsigned short port, int total)
144 {
145     int n = 0; 
146     GEventHandler *eh = nullptr; 
147 
148     do
149     {
150         eh = g_base.connect (port); 
151         if (eh == nullptr)
152             break;
153 
154         printf ("connect ok\n"); 
155         do_read (eh, total); 
156     } while (0); 
157 }
158 #endif
159 
160 int main (int argc, char *argv[])
161 {
162     if (argc < 2)
163     {
164         printf ("usage: epoll_clt port\n"); 
165         return -1; 
166     }
167 
168     unsigned short port = atoi (argv[1]); 
169 
170 #ifndef WIN32
171     struct sigaction act; 
172     act.sa_handler = sig_int; 
173     sigemptyset(&act.sa_mask);   
174     // to ensure read be breaked by SIGINT
175     act.sa_flags = 0; //SA_RESTART;  
176     if (sigaction (SIGINT, &act, NULL) < 0)
177     {
178         printf ("install SIGINT failed, errno %d\n", errno); 
179         return -1; 
180     }
181 #endif
182 
183     if (g_base.init (2) < 0)
184         return -1; 
185 
186     printf ("init ok\n"); 
187 
188 #if defined(TEST_READ)
189     test_read (port, 0); // 0 means infinite loop until user break
190 #elif defined(TEST_CONN)
191     test_conn (port, 10, 100); 
192 #elif defined (TEST_TIMER)
193     test_timer (port, 10, 1000); 
194 #else
195 #  error please define TEST_XXX macro to do something!
196 #endif
197 
198     if (!sig_caught)
199     {
200         // Ctrl + D ?
201         g_base.exit (0); 
202         printf ("exit ok\n"); 
203     }
204     else 
205         printf ("has caught Ctrl+C\n"); 
206 
207     g_base.fini (); 
208     printf ("fini ok\n"); 
209 
210     g_base.cleanup (); 
211     printf ("cleanup ok\n"); 
212     return 0; 
213 }

 

客戶端同樣使用了 GEventBase 的派生類 GMyEventBase 來作為事件循環的核心，所不同的是（注意並非之前例子里的那個類，雖然同名），它提供了 clt_handler 來處理自己的業務代碼。

另外為了提供連接中斷後自動向服務重連的功能，這裏 GMyEventBase 派生自 GEventBase 類的子類 GEventBaseWithAutoReconnect （位於 EventBaseAR.h/cpp 中）。

程序的運行是分別調用 GEventBase 的 init / connect / fini / cleaup 方法以及 GEventHandler 的 send / disconnect 來測試讀寫與連接。

定義宏 TEST_READ 用來測試讀寫；定義宏 TEST_CONN 可以測試連接的通斷及讀寫；定義宏 TEST_TIMER 來測試周期性定時器及讀寫。它們是互斥的。

clt_handler 主要用來異步接收服務端的回送數據並打印：

clt_handler.cpp

 1 #include "clt_handler.h"
 2 
 3 #ifdef TEST_TIMER
 4 extern void do_read (clt_handler *, int); 
 5 bool clt_handler::on_timeout (GEV_PER_TIMER_DATA *gptd)
 6 {
 7     printf ("time out ! id %p, due %d, period %d\n", gptd, gptd->due_msec, gptd->period_msec); 
 8     do_read ((clt_handler *)gptd->user_arg, 1); 
 9     return true; 
10 }
11 #endif
12 
13 void clt_handler::on_read_msg (Json::Value const& val)
14 {
15     int key = val["key"].asInt (); 
16     std::string data = val["data"].asString (); 
17     printf ("got %d:%s\n", key, data.c_str ()); 
18 }

 

這個測試程序可以通過在控制台手工輸入數據來驅動，也可以通過測試數據文件來驅動，下面的 awk 腳本用來製造符合格式的測試數據：

epoll_gen.awk

 1 #! /bin/awk -f
 2 BEGIN {
 3         WORDNUM = 1000
 4         for (i = 1; i <= WORDNUM; i++) {
 5                 printf("%d %s\n", randint(WORDNUM), randword(20))
 6         }
 7 }
 8 
 9 # randint(n): return a random integer number which is >= 1 and <= n
10 function randint(n) {
11         return int(n *rand()) + 1
12 }
13 
14 # randlet(): return a random letter, which maybe upper, lower or number. 
15 function randlet() {
16         return substr("abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789", randint(62), 1)
17 }
18 
19 # randword(LEN): return a rand word with a length of LEN
20 function randword(LEN) {
21         randw=""
22         for( j = 1; j <= LEN; j++) {
23                 randw=randw randlet()
24         }
25         return randw
26 }

 

生成的測試文件格式如下：

238 s0jKlYkEjwE4q3nNJugF
568 0cgNaSgDpP3VS45x3Wum
996 kRF6SgmIReFmrNBcCecj
398 QHQqCrB5fC61hao1BV2x
945 XZ6KLtA4jZTEnhcAugAM
619 WE95NU7FnsYar4wz279j
549 oVCTmD516yvmtuJB2NG3
840 NDAaL5vpzp8DQX0rLRiV
378 jONIm64AN6UVc7uTLIIR
251 EqSBOhc40pKXhCbCu8Ey

 

整個工程編譯的話就是一個 CMakeLists 文件，可以通過 cmake 生成對應的 Makefile 或 VS solution 來編譯代碼：

CMakeLists.txt

 1 cmake_minimum_required(VERSION 3.0)
 2 project(epoll_svc)
 3 include_directories(../core ../include)
 4 set(CMAKE_CXX_FLAGS "-std=c++11 -pthread -g -Wall ${CMAKE_CXX_FLAGS}")
 5 link_directories(${PROJECT_SOURCE_DIR}/../lib)
 6 set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/../bin)
 7 
 8 add_executable (epoll_svc epoll_svc.cpp svc_handler.cpp ../core/EventBase.cpp ../core/EventHandler.cpp ../core/log.cpp)
 9 IF (WIN32)
10 target_link_libraries(epoll_svc jsoncpp ws2_32)
11 ELSE ()
12 target_link_libraries(epoll_svc jsoncpp rt)
13 ENDIF ()
14 
15 add_executable (epoll_clt epoll_clt.cpp clt_handler.cpp ../core/EventBase.cpp ../core/EventBaseAR.cpp ../core/EventHandler.cpp ../core/log.cpp)
16 target_compile_definitions(epoll_clt PUBLIC -D TEST_READ)
17 IF (WIN32)
18 target_link_libraries(epoll_clt jsoncpp ws2_32)
19 ELSE ()
20 target_link_libraries(epoll_clt jsoncpp rt)
21 ENDIF ()
22 
23 add_executable (epoll_local epoll_local.cpp)
24 IF (WIN32)
25 target_link_libraries(epoll_local jsoncpp ws2_32)
26 ELSE ()
27 target_link_libraries(epoll_local jsoncpp rt)
28 ENDIF ()

 

 這個項目包含三個編譯目標，分別是 epoll_svc 、epoll_clt 與 epoll_local，其中前兩個可以跨平台編譯，后一個只能在 Linux 平台編譯，用來驗證 epoll 的一些特性。

編譯完成后，首先運行服務端：

>./epoll_svc 1025

 然後運行客戶端：

>./epoll_clt 1025 < demo

測試多個客戶端同時連接，可以使用下面的腳本：

epoll_start.sh

1 #! /bin/bash
2 # /bin/sh -> /bin/dash, do not recognize our for loop
3 
4 for((i=0;i<10;i=i+1))
5 do
6     ./epoll_clt 1025 < demo &
7     echo "start $i"
8 done

 

可以同時啟動 10 個客戶端。

※網頁設計一頭霧水該從何著手呢? 台北網頁設計公司幫您輕鬆架站!

透過資料庫的網站架設建置，建立公司的形象或購物系統，並提供最人性化的使用介面，讓使用者能即時接收到相關的資訊

通過 Ctrl+C 退出服務端；通過 Ctrl+C 或 Ctrl+D 退出單個客戶端；

通過下面的腳本來停止多個客戶端與服務端：

epoll_stop.sh

1 #! /bin/sh
2 pkill -INT epoll_clt
3 sleep 1
4 pkill -INT epoll_svc

 

 

框架的用法介紹完之後，再簡單遊覽一下這個庫的各層級對外接口。

EventBase.h

  1 #pragma once
  2 
  3 
  4 #include "EventHandler.h" 
  5 #include <string>
  6 #include <map>
  7 #include <mutex> 
  8 #include <condition_variable>
  9 #include "thread_group.hpp"
 10 
 11 #define GEV_MAX_BUF_SIZE 65536
 12 
 13 class GEventBase : public IEventBase
 14 {
 15 public:
 16     GEventBase();
 17     ~GEventBase();
 18 
 19 #ifdef WIN32
 20     virtual HANDLE iocp () const; 
 21 #else
 22     virtual int epfd () const; 
 23 #endif
 24     virtual bool post_timer(GEV_PER_TIMER_DATA *gptd); 
 25     virtual GEventHandler* create_handler() = 0; 
 26 
 27     // thr_num : 
 28     //  =0 - no default thread pool, user provide thread and call run
 29     //  <0 - use max(|thr_num|, processer_num)
 30     //  >0 - use thr_num
 31     bool init(int thr_num = -8, int blksize = GEV_MAX_BUF_SIZE
 32 #ifndef WIN32
 33               , int timer_sig = SIGUSR1
 34 #endif
 35               ); 
 36 
 37     bool listen(unsigned short port, unsigned short backup = 10);
 38     GEventHandler* connect(unsigned short port, GEventHandler* exist_handler = NULL); 
 39     // PARAM
 40     // due_msec: first timeout milliseconds
 41     // period_msec: later periodically milliseconds
 42     // arg: user provied argument
 43     // exist_handler: reuse the timer handler
 44     //
 45     // RETURN
 46     //   NULL: failed
 47     void* timeout(int due_msec, int period_msec, void *arg, GEventHandler *exist_handler);
 48     bool cancel_timer(void* tid); 
 49     void fini();  
 50     void run(); 
 51     void exit(int extra_notify = 0); 
 52     void cleanup(); 
 53 
 54 protected:
 55 #ifdef WIN32
 56     bool do_accept(GEV_PER_IO_DATA *gpid); 
 57     bool do_recv(GEV_PER_HANDLE_DATA *gphd, GEV_PER_IO_DATA *gpid); 
 58     void do_error(GEV_PER_HANDLE_DATA *gphd); 
 59 
 60     int init_socket();
 61     bool issue_accept(); 
 62     bool issue_read(GEV_PER_HANDLE_DATA *gphd);
 63     bool post_completion(DWORD bytes, ULONG_PTR key, LPOVERLAPPED ol); 
 64 
 65 #else
 66     bool do_accept(int fd); 
 67     bool do_recv(conn_key_t key); 
 68     void do_error(conn_key_t key); 
 69 
 70     bool init_pipe(); 
 71     void close_pipe(); 
 72     bool post_notify (char ch, void* ptr = nullptr); 
 73     void promote_leader (std::unique_lock<std::mutex> &guard); 
 74 
 75     GEventHandler* find_by_key (conn_key_t key, bool erase); 
 76     GEventHandler* find_by_fd (int fd, conn_key_t &key, bool erase); 
 77 
 78 #  ifdef HAS_SIGTHR
 79     void sig_proc (); 
 80 #  endif
 81 #endif
 82 
 83     bool do_timeout(GEV_PER_TIMER_DATA *gptd); 
 84 
 85     virtual bool on_accept(GEV_PER_HANDLE_DATA *gphd);
 86     virtual bool on_read(GEventHandler *h, GEV_PER_IO_DATA *gpid); 
 87     virtual void on_error(GEventHandler *h);
 88     virtual bool on_timeout (GEV_PER_TIMER_DATA *gptd); 
 89     
 90 
 91 protected:
 92     volatile bool m_running = false;
 93     int m_thrnum = 0; 
 94     int m_blksize = GEV_MAX_BUF_SIZE; 
 95     std::thread_group m_grp; 
 96     SOCKET m_listener = INVALID_SOCKET;
 97 
 98     std::mutex m_mutex;  // protect m_map
 99     std::mutex m_tlock; // protect m_tmap
100     // timer_t may conflict when new timer created after old timer closed
101     //std::map <timer_t, GEventHandler *> m_tmap; 
102     std::map <GEV_PER_TIMER_DATA*, GEventHandler *> m_tmap; 
103 
104 #ifdef WIN32
105     LPFN_ACCEPTEX m_acceptex = nullptr; 
106     LPFN_GETACCEPTEXSOCKADDRS m_getacceptexsockaddrs = nullptr; 
107     HANDLE m_iocp = NULL; 
108     HANDLE m_timerque = NULL; 
109 
110     std::map<GEV_PER_HANDLE_DATA*, GEventHandler*> m_map; 
111 #else
112     int m_ep = -1; 
113     int m_pp[2]; 
114     int m_tsig = 0; // signal number for timer
115 
116     std::mutex m_lock;   // protect epoll
117     pthread_t m_leader = -1; 
118     std::map<conn_key_t, GEventHandler*> m_map; 
119 #  ifdef HAS_SIGTHR
120     // special thread only cares about signal
121     std::thread *m_sigthr = nullptr; 
122 #  endif
123 #endif
124 };

 

  • init，它在底層啟動 thr_num 個線程來跑 run 方法；每次 IO 的塊緩衝區大小由 blksize 指定；它內部還創建了對應的 iocp 或 epoll 對象，便於之后加入 socket 句柄進行處理。
  • exit，它通知線程池中的所有線程退出等待，windows 上是通過 PostQueuedCompletionStatus，Linux 上是通過在自建的一個 pipe 上寫數據以觸發 epoll 退出（這個 pipe 在 init 中創建並加入 epoll）；
  • fini，它在所有工作線程退出后，關閉之前創建的對象，清理事件循環用到的資源；
  • cleanup，它清理之前建立的 fd-handler 映射，清理遺留的處理器並釋放資源；
  • run，它是線程池運行函數，windows 上是通過 GetQueuedCompletionStatus 在 iocp 上等待；在 linux 上是通過 epoll_wait 在 epoll 上等待事件。當有事件產生后，根據事件類型，分別調用 do_accept / on_accept、do_recv / on_read、do_error / on_error 回調來分派事件；
  • listen，創建偵聽 socket 並加入到 iocp 或 epoll 中；
  • connect，連接到遠程服務並將成功連接的 socket 加入到 iocp 或  epoll 中；
  • timeout，設置定時器事件，windows 上是通過 CreateTimerQueueTimer 實現定時器超時；linux 則是通過 timer_create 實現的，都是系統現成的東西，只不過在系統定時器到期后，給對應的 iocp 或 epoll 對象發送了一個通知而已，在 linux 上這個通知機制是上面提到過的 pipe 來實現的，因而有一定延遲，不能指定精度太小的定時器；
  • cancel_timer，取消之前設置的定時器。

 

然後看下 GEventHandler 提供的回調接口，應用可以從它派生並完成業務相關代碼：

EventHandler.h

  1 #pragma once
  2 #include "platform.h"
  3 
  4 #ifdef WIN32
  5 // must ensure <winsock2.h> precedes <widnows.h> included, to prevent winsock2.h conflict with winsock.h
  6 #  include <WinSock2.h>
  7 #  include <Windows.h>
  8 #  include <mswsock.h>  // for LPFN_ACCEPTEX & LPFN_GETACCEPTEXSOCKADDRS later in EventBase.h
  9 #else
 10 #  include <unistd.h> // for close
 11 #  include <sys/socket.h>
 12 #  include <sys/epoll.h>
 13 #  include <sys/time.h>
 14 #  include <netinet/in.h> // for struct sockaddr_in
 15 #  include <arpa/inet.h> // for inet_addr/inet_ntoa
 16 #  include <string.h> // for memset/memcpy
 17 #  include <signal.h>
 18 #endif
 19 
 20 #include <mutex>
 21 #include "jsoncpp/json.h"
 22 
 23 
 24 class GEventHandler; 
 25 struct GEV_PER_TIMER_DATA; 
 26 class IEventBase
 27 {
 28 public:
 29 #ifdef WIN32
 30     virtual HANDLE iocp () const = 0; 
 31 #else
 32     virtual int epfd () const = 0; 
 33 #endif
 34 
 35     virtual void* timeout(int due_msec, int period_msec, void *arg, GEventHandler *exist_handler) = 0; 
 36     virtual bool cancel_timer(void* tid) = 0; 
 37     virtual bool post_timer(GEV_PER_TIMER_DATA *gptd) = 0; 
 38 };
 39 
 40 
 41 #ifdef WIN32
 42 enum GEV_IOCP_OP
 43 {
 44     OP_TIMEOUT = 1, 
 45     OP_ACCEPT,
 46     OP_RECV,
 47 };
 48 #else 
 49 // the purpose of this key is to distinguish different connections with same fd !
 50 // (when connection break and re-established soon, fd may not change but port will change)
 51 struct conn_key_t
 52 {
 53     int fd; 
 54     unsigned short lport; 
 55     unsigned short rport; 
 56 
 57     conn_key_t (int f, unsigned short l, unsigned short r); 
 58     bool operator< (struct conn_key_t const& rhs) const; 
 59 }; 
 60 #endif
 61 
 62 
 63 struct GEV_PER_HANDLE_DATA
 64 {
 65     SOCKET so;
 66     SOCKADDR_IN laddr;
 67     SOCKADDR_IN raddr;
 68 
 69 #ifndef WIN32
 70     conn_key_t key () const; 
 71 #endif
 72 
 73     GEV_PER_HANDLE_DATA(SOCKET s, SOCKADDR_IN *l, SOCKADDR_IN *r); 
 74     virtual ~GEV_PER_HANDLE_DATA(); 
 75 };
 76 
 77 struct GEV_PER_IO_DATA
 78 {
 79     SOCKET so;
 80 #ifdef WIN32
 81     GEV_IOCP_OP op;
 82     OVERLAPPED ol;
 83     WSABUF wsa;         // wsa.len is buffer length
 84     DWORD bytes;        // after compeleted, bytes trasnfered
 85 #else
 86     char *buf; 
 87     int len; 
 88 #endif
 89 
 90     GEV_PER_IO_DATA(
 91 #ifdef WIN32
 92             GEV_IOCP_OP o, 
 93 #endif
 94             SOCKET s, int l); 
 95     virtual ~GEV_PER_IO_DATA(); 
 96 };
 97 
 98 struct GEV_PER_TIMER_DATA
 99 #ifdef WIN32
100        : public GEV_PER_IO_DATA
101 #endif
102 {
103     IEventBase *base; 
104     int due_msec; 
105     int period_msec; 
106     void *user_arg;
107     bool cancelled;
108 #ifdef WIN32
109     HANDLE timerque; 
110     HANDLE timer; 
111 #else
112     timer_t timer; 
113 #endif
114 
115     GEV_PER_TIMER_DATA(IEventBase *base, int due, int period, void *arg
116 #ifdef WIN32
117             , HANDLE tq);
118 #else
119             , timer_t tid); 
120 #endif
121 
122     virtual ~GEV_PER_TIMER_DATA(); 
123     void cancel (); 
124 };
125 
126 class GEventHandler
127 {
128 public:
129     GEventHandler();
130     virtual ~GEventHandler();
131 
132     GEV_PER_HANDLE_DATA* gphd(); 
133     GEV_PER_TIMER_DATA* gptd(); 
134     bool connected();
135     void disconnect(); 
136     void clear(); 
137     SOCKET fd(); 
138 
139     int send(char const* buf, int len);
140     int send(std::string const& str);
141     
142     virtual bool reuse();
143     virtual bool auto_reconnect();
144     virtual void arg(void *param) = 0;
145     virtual void reset(GEV_PER_HANDLE_DATA *gphd, GEV_PER_TIMER_DATA *gptd, IEventBase *base);
146     virtual bool on_read(GEV_PER_IO_DATA *gpid) = 0;
147     virtual void on_error(GEV_PER_HANDLE_DATA *gphd); 
148     // note when on_timeout called, handler's base may cleared by cancel_timer, use gptd->base instead if it is not null.
149     virtual bool on_timeout(GEV_PER_TIMER_DATA *gptd) = 0; 
150     virtual void cleanup(bool terminal);
151     void close(bool terminal);
152 
153 protected:
154     GEV_PER_HANDLE_DATA *m_gphd = nullptr; 
155     GEV_PER_TIMER_DATA *m_gptd = nullptr; 
156     IEventBase *m_base = nullptr;
157     // us so instead of m_gphd, 
158     // as the later one may destroyed during using..
159     SOCKET m_so;
160 };
161 
162 // a common handler to process json protocol.
163 class GJsonEventHandler : public GEventHandler
164 {
165 public:
166     //virtual void on_read();
167     virtual void arg(void *param);
168     virtual void reset(GEV_PER_HANDLE_DATA *gphd, GEV_PER_TIMER_DATA *gptd, IEventBase *base);
169     virtual bool on_read(GEV_PER_IO_DATA *gpid);
170     virtual void on_read_msg(Json::Value const& root) = 0;
171     virtual bool on_timeout(GEV_PER_TIMER_DATA *gptd);
172     virtual void cleanup(bool terminal);
173 
174 protected:
175     // protect m_stub to prevent multi-entry
176 #ifdef HAS_ET
177     std::mutex m_mutex; 
178 #endif
179 
180     std::string m_stub;
181 };

 

這裏主要有兩個類，GEventHandler 處理通用的基於流的數據；GJsonEventHandler 處理基於 json 格式的數據。

前者需要重寫 on_read 方法來處理塊數據；後者需要重寫 on_read_msg 方法來處理 json 數據。

目前 json 的解析是通過 jsoncpp 庫完成的，這個庫本身是跨平台的（本 git 庫僅提供 64 位 Linux 靜態鏈接庫及 VS2013 的 32 位 Release 版本 Windows 靜態庫）。

svc_handler 與 clt_handler  均從 GJsonEventHandler 派生。

如果有新的流格式需要處理 ，只需要從 GEventHandler 類派生新的處理類即可。

 

除了讀取連接上的數據，還有其它一些重要的回調接口，列明如下：

  • on_read，連接上有數據到達；
  • on_error，連接斷開；
  • on_tmeout，定時器事件；
  • ……

如果有新的事件需要處理 ，也可以在這裏擴展。

最後看下 GEventBaseWithAutoReconnect 提供的與自動重連相關的接口：

EventBaseAR.h

 1 #pragma once
 2 
 3 
 4 #include "EventBase.h"
 5 #include <thread>
 6 
 7 #define GEV_RECONNECT_TIMEOUT 2 // seconds
 8 #define GEV_MAX_RECONNECT_TIMEOUT 256 // seconds
 9 
10 class GEventBaseWithAutoReconnect : public GEventBase
11 {
12 public:
13     GEventBaseWithAutoReconnect(int reconn_min = GEV_RECONNECT_TIMEOUT, int reconn_max = GEV_MAX_RECONNECT_TIMEOUT);
14     ~GEventBaseWithAutoReconnect();
15 
16     bool do_connect(unsigned short port, void *arg);
17     GEventHandler* connector(); 
18 
19 protected:
20     virtual void on_error(GEventHandler *h);
21     virtual bool on_timeout(GEV_PER_TIMER_DATA *gptd);
22 
23     virtual void on_connect_break(); 
24     virtual bool on_connected(GEventHandler *app);
25 
26 protected:
27     void do_reconnect(void *arg);
28 
29 protected:
30     unsigned short m_port; 
31     GEventHandler* m_app;
32     GEventHandler* m_htimer; 
33     void* m_timer;
34     int m_reconn_min; 
35     int m_reconn_max; 
36     int m_reconn_curr;
37 };

 

其實比較簡單，只比 GEventBase 類多了一個  do_connect 方法，來擴展 connect 不能自動重連的問題。

底層的話，是通過定時器來實現指數後退重連算法的。

 

最後，如果你還是感到雲里霧裡的，可以參考一下下面的類結構圖：

 

 

黑色標註的是框架提供的類，紅色是服務端派生的類，藍色是客戶端派生的類，其實 GMyEventBase 的唯一作用就是將 svc_handler 與 clt_handler 分別引入各自的框架中，

所以用戶的關注點主要還是在派生自己的 GEventHandler 類，並在其中的回調接口中處理數據就可以了。

 

 

後記

這個框架已經應用到我司的公共產品中，併為數個 tcp 服務提供底層支撐，經過百萬級別用戶機器驗證，運行穩定性還是可以的，所以當得起“工業級”這三個字。

 

前面在說到開源庫的選型時還留了一個口子沒有交待，這裏一併說下。

其實最早的重構版本是使用 libevent 來實現的，但是發現它在 windows 上使用的是低效的 select，

而且為了增加、刪除句柄，它又使用了一種 self-pipe-trick 的技巧，簡單說來的就是下面的代碼序列：

listen (listen_fd, 1); 
……
connect (connect_fd, &addr, size); 
……
accept_fd = accept (listen_fd, &addr, &size);

 

在缺乏 pipe 調用的 win32 環境製造了一個 socket 自連接，從而進行一些通知。

這一步是必要的，如果不能成功連接就會導致整個 libevent 初始化失敗，從而運行不起來。

不巧的是，在一些 windows 機器上（約佔用戶總量 10%），由於防火牆設置嚴格，上述 listen 與 connect 調用可以成功，

但是 accept 會失敗返回，從而導致整個服務退出 （防火牆會嚴格禁止不在白名單上偵聽的端口的連接）。

對於已知端口，可以通過在防火牆上設置白名單來避免，但是對於這種隨機 listen 的端口，真的是太難了，基本無解。

 

回頭考察了一下 asio，windows 上使用的是 iocp，自然沒有這個自連接；

ACE 有多種實現可供選擇，如果使用  ACE_Select_Reactor / ACE_TP_Reactor 是會有這個自連接，

但是你可以選擇其它實現，如基於 WaitForMultipleEvents 的 ACE_WFMO_Reactor（最大隻支持 62 個句柄，放棄），

或基於 iocp 的 ACE_Proactor （前攝式，與反應式在編程上稍有不同，更接近於 asio）就沒有這個自連接。

 

再說的深一點，其實公司最早的網絡庫使用的就是基於 boost 的 asio，大量的使用了 c++ 模板，

有時候產生了一些崩潰，但是根據 dump 完全無法定位崩潰點（各種冗長的模板展開名稱），

導致了一些頑固的已知 bug 一直找不到崩潰點而無法解決（雖然量不大），所以才有了要去重新選型網絡庫以及後來這一系列的東西。

 

本來一開始我是想用 ACE 的，因為我讀過這個庫的源碼，對裏面所有的東西都非常熟悉，

但是看看 ACE 小 5 MB 的 dll 尺寸，還是放棄了（產品本身安裝包也就這麼大吧），

對於一個公司底層的公共組件，被各種產品攜帶，需要嚴格控制“體重”

（後來聽說 ACE 按功能拆分了代碼模塊，你只需要選自己依賴的部分即可，不過我還沒有試過）。

 

使用這個庫代替之前的 boost::asio 后，我還有一個意外收穫，就是編譯出來的 dll 尺寸明顯小了很多，700 K -> 500 K 的樣子，看來所謂模板膨脹是真有其事……

 

最後奉上 gevent 的 github 鏈接，歡迎有相同需求的小夥伴前來“復刻” ：

https://github.com/goodpaperman/gevent

 

本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理

※網頁設計一頭霧水該從何著手呢? 台北網頁設計公司幫您輕鬆架站!

當全世界的人們隨著網路時代而改變向上時您還停留在『網站美醜不重要』的舊有思維嗎？機會是留給努力改變現況的人們，別再浪費一分一秒可以接觸商機的寶貴時間！

《英雄再臨》熱血開播，10月18日重新定義英雄_電子煙

發佈日期: 作者:

※你應該要知道的電子煙懶人包!

成品芯儲油槽皆為空槽設計，需自行添加。超輕巧方便隨身攜帶，簡易操作。1.0歐姆陶瓷彈夾表現細細品嚐。綿密細緻的真實感受

　　由菠蘿包輕小說、企鵝影視出品，廣州大火鳥文化製作，同名漫畫改編的超人氣動畫《英雄再臨》已於10月18日在騰訊視頻獨家播出，在這個寒冷的秋天，再一次點燃你的熱血!

　　漫畫版《英雄再臨》是一部在全網人氣超過400億，總收藏超過450萬，登上2019年度騰訊動漫總榜TOP10，登頂暢銷、人氣、月票榜等各大榜單的熱血少年漫畫作品。這麼多含金量超高的Title足以證明它在動漫界不容撼動的地位。這一次，它被搬上熒幕，以動畫的形式與大家見面。

　　該動畫講述了一位最強英雄隱退後又被迫營業拯救世界的故事。是的，“被迫營業”，一個清新脫俗的非典型英雄故事。

　　2093年，當人類遭受來源不明的怪獸襲擊，世界遭遇毀滅性打擊之時，人類史上第一位超級英雄——零，出現了。

　　邪惡勢力被他一一擊垮，他帶領人類走出黑暗，走向光明。正義召喚出更大的正義，一大批超級英雄相繼湧現，世界犯罪率逐年下降。

　　而就在此時，作為人類救世主的零，卻突然銷聲匿跡……

　　你以為超級英雄零是陷入了什麼陰謀陷阱難以脫身?或是在拯救世界之後低調地功成身退?畫風一轉，零卻以另一幅面目——一個有些頹廢的少年形象出現在了人氣組合十神世家的演唱會台下。原來消失的這幾年裡，他只是待在家裡混吃混喝……而之所以消失，不過是因為當年的中二病忽然好了。“零”這個聽起來有點破碎的非主流名字當然也不是真名，他的真實姓名叫林劫。

　　與以往超級英雄無所不能的形象不同，匡扶正義的林劫，拋去英雄的光環，卻是一個家裡蹲五年，筆試不及格，迷戀少女遊戲的喪系男主。強烈的反差瞬間拉近了觀眾與人物的距離，讓我們看到一個不一樣的超級英雄。

※老司機曝包養內幕

充滿魅力的妳….是否希望愛情與麵包也能兼得呢?

　　年少時的中二壯舉，雖然現在聽起來有點羞恥，卻鼓勵了越來越多的年輕人。在一場打鬥中，林劫結識了名叫戰晨的E級英雄，沒錯，在這個的次元里，英雄是分級的。戰晨擁有十八般兵器，但沒一個好使的，空有一腔熱血，非要制服等級較他更高的C級通緝犯黑手，卻屢遭打臉，實在看不下去的林劫只好出手相救。一招KO對手的炫酷技能瞬間把戰晨征服了，吵着要跟林劫組戰隊;而家底豐厚的戰晨也成功用金錢征服了林劫?二人組隊成功。

　　接下來，兩人又先後結識受氣包眼鏡嚴慶和自帶讓身邊人無差別倒霉屬性的十三，二人也紛紛加入了戰隊。四人之中，除了林劫本人，其他幾人都是零的鐵粉，當然他們短期內還不知道林劫就是零。出於對正義的嚮往以及對零的崇拜，奇奇怪怪的組合出現了……

　　不知這麼一群奇葩聚在一起，會碰撞出怎樣的火花?“邊緣”英雄又如何在神級大佬的帶領下走上拯救世界的逆襲之路?

　　《英雄再臨》熱血又不失搞笑，動畫版將角色的神情變化、肢體動作等直觀地展現在熒幕上，使搞笑效果加倍;而酣暢帶感拳拳到肉的打鬥場面，或許也只有動畫才可以更好的呈現，再配合震撼炸耳的BGM，瞬間點燃你的一腔熱血。

　　對比漫畫版《英雄再臨》，動畫版保留了原著大部分笑點的同時，略微精簡了一些與主線無關的情節。人物性格上少了一些邪氣傲慢，多了一分英雄的從容與包容。

　　作為一部熱血的動漫作品，《英雄再臨》有着积極正向的思想傳輸。神級英雄不沉迷於過去的戰績，甘願從頭開始;E級英雄也不卑不亢，誓要懲惡揚善。A級英雄是英雄，E級也是，林劫的戰隊似乎重新定義了英雄一詞：心懷正義就是英雄。

　　現在，那個消失了五年的傳說級英雄帶着他的團隊回來了。每周日10點，來騰訊視頻，看傳奇英雄拯救世界!

　　 網站內容來源:中國娛樂網訊www.yule.com.cn

※男人為什麼總愛舒壓按摩台北外送茶交流呢？

花茶坊全台提供外送茶莊，用最親切的互動方式，保證讓您回味無窮唷

富邦集團4.79億元競得寧波江北區1宗住宅用地 溢價率2.57%_家具工廠推薦

發佈日期: 作者:

※想知道北部最多平價、庫存出清的家具工廠推薦在哪裡?

鑫沅傢俱在早期以生產現代家具為主!
我們為了轉型提升了工廠設備開始做產業鏈裡最難做的新古典家具，因雕刻的美感需要有經驗的工匠而工匠再賦予傢俱新的生命感

中國網地產訊 9月28日，寧波江北區1宗住宅用地成功出讓，經過12輪競價，寧波富邦蓀湖置業有限公司（富邦集團）以總價47943.36萬元競得江北區CC13-01-16（蓀湖南王家西側）地塊，樓麵價11590元/㎡，溢價率2.57%。

地塊編號甬儲出2020-114號，地塊名稱江北區CC13-01-16（蓀湖南王家西側）地塊，出讓面積3.93萬平，用途為住宅用地，容積率1.05，建築面積4.13萬平，起始價4.67億元。

據土地出讓文件显示，紅線內規劃配建內容由競得人根據規劃要求同步實施，建成后按規定移交；本地塊實施“限房價、限地價、競配建”方式出讓。該地塊商品住宅毛坯銷售均價不高於21800元/平方米，商品住宅毛坯最高銷售單價不高於32700元/平方米。車位銷售價格不高於20萬元/個。

※新屋購入，尋找台中室內設計師?是否可先免費估價丈量?

『Wood Work Studio沐作空間設計』，取自英文木工施作，台中沐作室內設計公司專注於原木的質感挑選、特色風格打造與提供專業建議，服務範圍包含老宅更新

（責任編輯：楊昊岳）

中國網地產是中國互聯網新聞中心·中國網旗下地產頻道，是國內官方、權威、專業的國家重點新聞網站。以引導正確的行業輿論導向為己任，為行業上下游關聯企業、相關產業提供一個高效溝通與互動的優質平台。

※挑好磚一點都不難!馬賽克磚挑選眉角小撇步!

以認真精妙的陶瓷創作精神，將藝術傳達到世界上各個角落；
把〝藝術生活化，生活藝術化〞是我們的座右銘。

麗水勇安地產2.01億元競得浙江麗水1宗商住用地 溢價率157.69%_木質地板

發佈日期: 作者:

※分享木質地板DIY自行施工教學影片

手工精雕 歐風橡 立體浮紋系列~5.4寸地板、6.4寸地板、9.2寸壁板、訂製踏板、桌板、層板

中國網地產訊 9月28日，麗水蓮都區2宗商住用地集中出讓，總起始價6.68億元，總建築面積18.26萬平。最終經過124輪競價，麗水勇安開發有限公司以總價2.01億元競得蓮都區碧湖鎮2018(144)號地塊，樓麵價1568元/㎡，溢價率157.69%。

地塊編號麗土告字〔2020〕47號，地塊名稱蓮都區碧湖鎮2018(144)號地塊，出讓面積6.4萬平，用途為商住用地，容積率2，建築面積12.81萬平，起始價7800萬元。

※推薦沙發修理,老師傅的專業手工!

有單人坐的、雙人或多人坐的，坐著柔軟舒適；是軟件家具的一種

（責任編輯：楊昊岳）
相關閱讀：

中國網地產是中國互聯網新聞中心·中國網旗下地產頻道，是國內官方、權威、專業的國家重點新聞網站。以引導正確的行業輿論導向為己任，為行業上下游關聯企業、相關產業提供一個高效溝通與互動的優質平台。

※家中裝潢適合實木地板嗎?注意五大鋪設狀況

實木地板、海島型木地板、超耐磨木地板 、柚木地板 責任施工、保固

吉翔置地4.41億元競得嘉興南湖區1宗住宅用地 溢價率39.83%_海島型木地板

發佈日期: 作者:

※海島型木地板專業木作修繕團隊

實木地板為”天然”木材色澤，花紋以自然為主，請施工者自行分色，挑選後再行施工。

中國網地產訊 9月28日，嘉興南湖區1宗住宅用地成功出讓，經過98輪競價，吉翔置地集團有限公司以上限價44112萬元競得2020南-034號地塊，樓麵價10040元/㎡，溢價率39.83%，競配人才住房7600㎡。

地塊編號嘉土告南字〔2020〕27號，地塊名稱為2020南-034號地塊，出讓面積2.92萬平，用途為住宅用地，容積率1.5，建築面積4.39萬平，起始價3.15億元。

※打造簡約、淡雅兼收納空間的小資房，台中室內設計推薦哪一家?

室內空間裝潢、商業室內設計、木作施工、訂製家具、零售批發家具。客戶與專業工班團隊來回溝通方案，帶著一股職人精神與多年累積的豐富經驗，創造出符合客戶心目中的作品。

據土地出讓文件显示，地塊按照容積率1.5測算總建築面積及出讓總價。其他土地利用要求本地塊採用“競價+競配建人才住房”方式拍賣出讓；人才住房的面積標準為80-100平方米，上下浮動5平方米，所有配建的人才住房須無償交給政府指定的單位（產權接收方），並按視同銷售繳納有關稅費，稅費繳納按規定由雙方各自繳納，其中接收方承擔契稅和印花稅；競得人須在嘉興科技城註冊成立新公司進行本地塊的開發建設（已成立公司的除外）。

（責任編輯：楊昊岳）
相關閱讀：

中國網地產是中國互聯網新聞中心·中國網旗下地產頻道，是國內官方、權威、專業的國家重點新聞網站。以引導正確的行業輿論導向為己任，為行業上下游關聯企業、相關產業提供一個高效溝通與互動的優質平台。

※居家隱形鐵窗安裝施作經驗分享

隨著城市發展，各都會高樓林立，也造成小孩及老人墜樓的意外頻頻發生，新寶隱形鐵窗研發改良高科技產品隱形鐵窗、防墜窗，全部零主件均是『台灣在地生產製造』，品質可靠，用心及推薦提供良好居家安全。

華鴻嘉信8.05億元競得浙江麗水蓮都區1宗商住用地 溢價率36.44%_沙發換皮

發佈日期: 作者:

※沙發換皮省更多,延長老沙發壽命!

沙發是家裡使用頻率最高的家具之一，隨著長時間使用，難免出現表皮磨損、坐墊凹陷等狀況

中國網地產訊 9月28日，浙江麗水蓮都區2宗商住用地集中出讓，總起始價6.68億元，總建築面積18.26萬平。經過107輪競價，永嘉鴻辰置業有限公司（華鴻嘉信）以總價80500萬元競得欣苑街與括蒼路交叉口西南側地塊，樓麵價14807元/㎡，溢價率36.44%。

地塊編號麗土告字〔2020〕46號，地塊名稱欣苑街與括蒼路交叉口西南側地塊，出讓面積2.58萬平，用途為商住用地，容積率2.1，建築面積5.43萬平，起始價5.9億元。

※了解海島型木地板是否會有潮濕變形疑慮?

結構為在木夾板表面貼實木皮，比實木地板穩定性高、不易變形翹起，「海島型木地板」名稱由來乃是此類地板非常適合灣溫濕多雨的海島型氣候。

據土地出讓文件显示，地塊內配建市場建築（農產品交易）不少於3600平方米（含附屬式公廁和垃圾中轉站），用地面積不少於5000平方米。市場用房竣工驗收合格后，產權無償移交政府統一管理使用。

（責任編輯：楊昊岳）
相關閱讀：

中國網地產是中國互聯網新聞中心·中國網旗下地產頻道，是國內官方、權威、專業的國家重點新聞網站。以引導正確的行業輿論導向為己任，為行業上下游關聯企業、相關產業提供一個高效溝通與互動的優質平台。

※木地板哪有幾種款式?該如何選購適合的材質呢?

家中如想要有實木的感覺，但卻居住在潮濕的地方如海邊、山上，就建議選擇海島型木地板；想有實木質感且居住地乾燥，預算也許可，則可選擇實木地板；家裡有小朋友奔跑遊戲，或有易刮傷木地板的寵物，則建議選擇超耐磨木地板。

浙江麗水蓮都區10.06億元出讓2宗商住用地_隱形鐵窗

發佈日期: 作者:

※屬於你的居家品味，家具訂製工廠推薦與心得分享

所謂的精品級訂製家具即是台灣家具製造廠參考各大國際品牌的設計，包含其外型與機能，使用相同甚至更好的五金與材料

中國網地產訊 9月28日，浙江麗水蓮都區2宗商住用地集中出讓，總起始價6.68億元，總建築面積18.26萬平，總成交價10.06億元。

經過107輪競價，永嘉鴻辰置業有限公司（華鴻嘉信）以總價80500萬元競得欣苑街與括蒼路交叉口西南側地塊，樓麵價14807元/㎡，溢價率36.44%。

地塊編號麗土告字〔2020〕46號，地塊名稱欣苑街與括蒼路交叉口西南側地塊，出讓面積2.58萬平，用途為商住用地，容積率2.1，建築面積5.43萬平，起始價5.9億元。

據土地出讓文件显示，地塊內配建市場建築（農產品交易）不少於3600平方米（含附屬式公廁和垃圾中轉站），用地面積不少於5000平方米。市場用房竣工驗收合格后，產權無償移交政府統一管理使用。

※柚木地板是什麼，其材料規格及適合施作環境?

平常要保持木質本身的油性，一般地板剛施工完成時，木頭表面上都有油脂，這些油脂可防潮，但油脂日久會逐漸磨損，所以可視情況補充地板腊讓地板保持油質。

最終經過124輪競價，麗水勇安開發有限公司以總價2.01億元競得蓮都區碧湖鎮2018(144)號地塊，樓麵價1568元/㎡，溢價率157.69%。

地塊編號麗土告字〔2020〕47號，地塊名稱蓮都區碧湖鎮2018(144)號地塊，出讓面積6.4萬平，用途為商住用地，容積率2，建築面積12.81萬平，起始價7800萬元。

（責任編輯：楊昊岳）
相關閱讀：

中國網地產是中國互聯網新聞中心·中國網旗下地產頻道，是國內官方、權威、專業的國家重點新聞網站。以引導正確的行業輿論導向為己任，為行業上下游關聯企業、相關產業提供一個高效溝通與互動的優質平台。

※想知道更多隱形鐵窗QA,都在生活知識王!!

高樓防墜，但又要兼顧美觀，加裝隱形鐵窗是您可以考慮的選擇！！隱形鐵窗具有『防墜、防盜、安全、美觀』等四大優點，能滿足您的居住需求及較易被大樓或社區管委會所接受，可減少不必要的爭端。

奧園+恆基聯合體67.78億元競得廣州1宗商住用地 溢價率11.15%_台中室內設計

發佈日期: 作者:

※門外漢也要知道的超耐磨木地板祕辛?

木質地板的清潔，先用吸塵器吸淨灰塵，再用沾濕抹布擦拭(或靜電拖把)即可，但每隔一段時間應使用地板腊，重新補充地板表層所損失的油脂。

中國網地產訊 9月28日，廣州1宗商住用地成功出讓。經35輪報價，最終由廣州奧昇置業有限公司（奧園+恆基）以67.78億元競得，摺合樓麵價22230/㎡，溢價率11.15%。

地塊編號穗規劃資源掛出告字〔2020〕64號，地塊位於番禺區新造鎮新化快速路東側地塊，土地用途為商住用地，宗地面積140537平方米(可建設用地面積101371平方米)，起始價60.98億元。

據土地出讓文件显示，競得人須在地塊一內提供建築面積13746平方米住房，上述住房由廣州市番禺區指定單位按3500元/平方米的價格回購。競得人須提供206個機動車停車位供政府性回購住房住戶購置或租賃使用，購置標準或租賃標準與該項目其他車位價格一致。政府回購住房的位置、戶型套數等需在報建（修建性詳細規劃、建設工程規劃許可證）前取得廣州市番禺區的同意，建設質量、裝修標準與該項目其他房屋建設、裝修標準一致。若土地受讓人開發的商品住宅存在多個裝修標準時，政府性回購住房的建設質量、裝修標準需取得廣州市番禺區的同意。

※裝潢大小事!隔音防火工程施工案例分享

吸音棉是經過特殊處理形成一面凹凸波浪形狀的一種海綿材料，其內部充滿細小空隙及半開孔結構能大量吸收射入的聲波能量，對聲波起到衰減作用，能降低室內反射聲的干擾和迴響提高聲音的純度是吸音降噪材料的高性能產品。

政府性回購住房需與首期工程同步建設、同步驗收。政府性回購住房在辦理房屋回購交易手續時，雙方按購房合同約定支付購房款，按規定各自支付相應的稅費。政府性回購住房物業管理費在房屋移交給廣州市番禺區指定單位之日起，3年內由競得人承擔，3年後由廣州市番禺區指定單位或住戶繳交，具體繳費標準由廣州市番禺區指定單位或住戶與物業管理公司約定。

（責任編輯：楊昊岳）
相關閱讀：

中國網地產是中國互聯網新聞中心·中國網旗下地產頻道，是國內官方、權威、專業的國家重點新聞網站。以引導正確的行業輿論導向為己任，為行業上下游關聯企業、相關產業提供一個高效溝通與互動的優質平台。

※中古屋大改造，分享台中室內設計隔間重新規劃，擴大實用空間!

日復一日生活在冰冷的水泥建築中，高樓林立的都會叢林反映了時代的進步，卻少了一些人與自然溫度。室內設計公司習慣運用大量木材質感於室內空間上