最近一直在研究微服務相關內容,通過對比各大API閘道器,發現新起之秀 APISIX無論從開源程度上來講還是功能上,都擁有很大的優勢。
經歷了幾天折磨一樣的學習,目前在本地環境中設定成功了一套,以供自己留存吧,實在是網上的很多文章要麼太老了,要麼就是亂寫一通。
APISIX官方網址:https://apisix.apache.org/
ETCD官方網址:https://etcd.io/
1、安裝ETCD(分散式Key-Value儲存系統)
根據apisix提供的官方網檔,執行以下指令碼就可以了:
wget https://github.com/etcd-io/etcd/releases/download/v3.5.8/etcd-v3.5.8-linux-amd64.tar.gz tar -xvf etcd-v3.5.8-linux-amd64.tar.gz && \ cd etcd-v3.5.8-linux-amd64 && \ sudo cp -a etcd etcdctl /usr/bin/
這裡的安裝時間因為國內的原因,可能需要執行很長時間,我們同樣也可以將檔案提前下載好,丟到CentOS伺服器上,再執行解壓縮就可以了。
2、設定ETCD
不知道是我找的資料不對,還是官方精簡了一些,本打算使用 systemctl 安裝ETCD,但是各種提示報錯,經過了大量的資料搜尋和文章的研究與嘗試,這裡需要以下步驟進行安裝設定:
(1)建立 /etc/etcd/etcd.service 服務組態檔,並編輯內容如下(本範例為單機模式部署):
ETCD_NAME=etcd ETCD_DATA_DIR=/etc/etcd/data ETCD_LISTEN_CLIENT_URLS=http://0.0.0.0:2379 ETCD_LISTEN_PEER_URLS=http://0.0.0.0:2380 ETCD_ADVERTISE_CLIENT_URLS=http://0.0.0.0:2379 ETCD_INITIAL_ADVERTISE_PEER_URLS=http://0.0.0.0:2380 ETCD_INITIAL_CLUSTER_STATE=new ETCD_INITIAL_CLUSTER_TOKEN=etcd-cluster
編寫完成後,儲存即可。
(2)以服務方式啟用及啟用載入自啟
systemctl start etcd systemctl enable etcd
到這裡,整個ETCD服務就安裝完成了
3、安裝APISIX
這一步操作很簡單,直接根據官方檔案來操作就可以了,安裝說明:https://apisix.apache.org/docs/apisix/installation-guide/
(1)安裝OpenRestry並且安裝APISIX包
sudo yum install -y https://repos.apiseven.com/packages/centos/apache-apisix-repo-1.0-1.noarch.rpm
(2)新增APISIX YUM包源
sudo yum-config-manager --add-repo https://repos.apiseven.com/packages/centos/apache-apisix.repo
(3)執行APISIX安裝
# 預設安裝 sudo yum install apisix # 指定版本安裝 sudo yum install apisix-3.3.0
安裝完APISIX我們先不要啟動,先去 /usr/local/apisix/conf/config.yaml中修改對應的檔案設定,我這例子的設定如下:
# # Licensed to the Apache Software Foundation (ASF) under one or more # contributor license agreements. See the NOTICE file distributed with # this work for additional information regarding copyright ownership. # The ASF licenses this file to You under the Apache License, Version 2.0 # (the "License"); you may not use this file except in compliance with # the License. You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # # If you want to set the specified configuration value, you can set the new # in this file. For example if you want to specify the etcd address: # # deployment: # role: traditional # role_traditional: # config_provider: etcd # etcd: # host: # - http://127.0.0.1:2379 # # To configure via environment variables, you can use `${{VAR}}` syntax. For instance: # # deployment: # role: traditional # role_traditional: # config_provider: etcd # etcd: # host: # - http://${{ETCD_HOST}}:2379 # # And then run `export ETCD_HOST=$your_host` before `make init`. # # If the configured environment variable can't be found, an error will be thrown. # # Also, If you want to use default value when the environment variable not set, # Use `${{VAR:=default_value}}` instead. For instance: # # deployment: # role: traditional # role_traditional: # config_provider: etcd # etcd: # host: # - http://${{ETCD_HOST:=localhost}}:2379 # # This will find environment variable `ETCD_HOST` first, and if it's not exist it will use `localhost` as default value. # apisix: node_listen: 8000 deployment: role: traditional role_traditional: config_provider: etcd etcd: host: - http://127.0.0.1:2379 admin: admin_key: - name: admin key: edd1c9f034335f136f87ad84b625c8f1 # using fixed API token has security risk, please update it when you deploy to production environment role: admin
這裡要注意的是,apisix: node_listen 是不存在的,你要自己新增上並指定一下需要繫結的埠,並且在etcd 下的host 指定你ETCD伺服器安裝的位置(推薦使用內網,不要對外開放埠哈)
這裡設定完成後,我們就可以使用systemctl啟動APISIX咯
# 使用systemctl 將APISIX安裝為服務
systemctl start apisix
# 新增服務開機自啟動
systemctl enable apsix
啟動成功後,通過存取網址 http://127.0.0.1:8000 會提示404 Route Not Found的字樣,這時,我們的APISIX服務就安裝完成咯!
4、安裝APISIX-DASHBOARD(管理控制面板)
同樣的,我們根據官方給的檔案進行安裝,檔案地址:https://apisix.apache.org/docs/dashboard/install/
因為我們使用的CENTOS直接安裝,那麼我們執行如下的BASH指令碼即可:
sudo yum install -y https://github.com/apache/apisix-dashboard/releases/download/v3.0.1/apisix-dashboard-3.0.1-0.el7.x86_64.rpm
安裝需要一定的時間,安裝完成後記得去 /usr/local/apisix/dashboard/conf/conf.yaml 檔案中修改對應的設定ETCD地址及管理員、使用者的賬號及密碼!
以上操作完成後,同樣的執行以下命令,apisix-dashboard也就啟動完成,我這裡預設開的是9000埠,那麼完成後通過瀏覽器存取 http://127.0.0.1:9000 就可以使用咯
# 使用systemctl 將APISIX-DASHBOARD安裝為服務 systemctl start apisix-dashboard # 新增服務開機自啟動 systemctl enable apsix-dashboard
以上所有便是APISIX在centos 7.6的安裝過程,如果安裝中大家有什麼問題,可以一起留言討論一下