![](https://intranetproxy.alipay.com/skylark/lark/0/2022/jpeg/22456429/1651822562003-a6222129-c117-4b41-8df9-b3278aabdcd8.jpeg#clientId=u18f5a091-6997-4&crop=0&crop=0&crop=1&crop=1&from=paste&id=u8c2cba52&margin=%5Bobject%20Object%5D&originHeight=383&originWidth=900&originalType=url&ratio=1&rotation=0&showTitle=false&status=done&style=none&taskId=u05415c22-d518-4f7d-8ef7-7620aa1baeb&title=)
作者 | 劉宇（花名：江昱）

在上篇[《即學即會 Serverless | 如何解決 Serverless 應用開發部署的難題》](http://mp.weixin.qq.com/s?__biz=MzI4NzI5MDM1MQ==&mid=2247509078&idx=1&sn=06ee9f179e11704fb693350f2ec0ac6f&chksm=ebcd02d6dcba8bc099fe74de5ebb55e4e56fe804b41b10c960b81d5f9fdc055ec67282d80c5a&scene=21#wechat_redirect)中，我們闡述了工具鏈的重要性，那麼本文將帶領各位快速實現 Serverless Devs 入門。

# 安裝工具

- 第一步：請先安裝 Node.js(>=10.8.0) 與 NPM 包管理工具；
- 第二步：安裝 Serverless Devs 開發者工具；具體的安裝方式參考文件：

_https://help.aliyun.com/document_detail/195474.html_

```
$ npminstall @serverless-devs/s -g
```

- 第三步：可以透過 s -v 判斷工具是否安裝成功，如果安裝成功可以看到相對應的版本資訊，例如：

```
@serverless-devs/s:2.0.89, @serverless-devs/core: 0.1.7, darwinarwin-x64, node-v12.15.0
```

# 配置金鑰
## 獲取金鑰

配置 Serverless Devs 的阿里雲金鑰，一般需要金鑰資訊，獲取頁面為：
_https://usercenter.console.aliyun.com/#/manage/ak__

- AccessKeyID：使用者的 AK 資訊
- AccessKeySecret：使用者的 SK 資訊

關於金鑰資訊的獲取流程如下：開啟獲取金鑰頁面；_https://usercenter.console.aliyun.com/#/manage/ak_

並獲取金鑰資訊 ：

**引導式金鑰配置**

透過引導式進行金鑰配置：可以透過 s config add 命令，進行引導式建立：

執行 s config add ，並選擇 Alibaba Cloud (alibaba)：
```
$ s config add? Please select a template: Alibaba Cloud(alibaba)?Refer to the document for alibaba key: http://config.devsapp.net/account/alibaba? AccountID ()
```

此時，可以按照引導，進行金鑰的配置：
```
? Please select a template: Alibaba Cloud(alibaba)
?Refer to the document for alibaba key: http://config.devsapp.net/account/alibaba
? AccessKeyID 此處填寫AccessKeyID
? AccessKeySecret 此處填寫AccessKeySecret
? Please create alias for key pair. Ifnot, please enter to skip alibaba-access

Alias: alibaba-access   AccountID:此處填寫AccountID
   AccessKeyID: 此處填寫AccessKeyID
   AccessKeySecret: 此處填寫AccessKeySecret

Configuration successful
```

致此，透過引導式，我們完成了金鑰配置資訊。
## 命令式金鑰配置

為了在一些自動化流程中可以更好的使用 Serverless Devs，所以除了透過引導式進行金鑰的配置， Serverless Devs 還支援透過命令列非互動式進行金鑰的配置。

同樣以阿里雲金鑰配置為例，可以直接透過引數將金鑰資訊傳入：
```

$ s configadd --AccessKeyID myAccessKeyID --AccessKeySecret myAccessKeySecret -a demoAlias: demoAccountID: myAccountIDAccessKeyID: myAccessKeyIDAccessKeySecret: myAccessKeySecretConfigurationsuccessful
```

如果需要配置更多格式的金鑰資訊，可以透過自定義 Key-Value 實現，例如：
```
$ s config add--AccessKeyID ****** -kl key1,key2,key3 -il info1,info2,info3 -a demo-2Alias: demo-2key1: info1key2: info2key3: info3AccessKeyID: codeConfigurationsuccessful
```

## 透過環境變數配置
有相當一部分的開發者會將金鑰資訊放在環境變數中，這樣在使用工具的時候，就需要從環境變數中讀取金鑰資訊，此時，透過環境變數配置金鑰的方法就顯得尤為重要，為此，Serverless Devs 提供了兩種透過環境變數配置金鑰的方法：

**方法 1: 直接透過 config add 進行配置**

這種方法很簡單，基本和上面所描述的命令式金鑰配置是類似的，只不過傳入的不是固定值，而是環境變數，例如在環境變數中有：

ALIBABA_CLOUD_ACCESS_KEY_ID、ALIBABA_CLOUD_ACCESS_KEY_SECRET 等相關內容；

此時可以透過 s configadd 命令進行新增：
```

$ s config add -adefault-aliyun -kl AccessKeyID,AccessKeySecret -il${ALIBABA_CLOUD_ACCESS_KEY_ID},${ALIBABA_CLOUD_ACCESS_KEY_SECRET}
```

**方法 2: 透過指定名稱使用環境變數金鑰**

透過指定環境變數的名字進行配置：例如當前有阿里雲金鑰對：
```
AccountID:temp_accountid
AccessKeyID:temp_accesskeyid
AccessKeySecret:temp_accesskeysecret
```

此時可以在環境變數中可以命名 key 為*********_serverless_devs_access，

例如 default_serverless_devs_access，value 為 JSON 字串，如：
```
Key：default_serverless_devs_access
Value：{\"AccessKeyID\":\"temp_accesskeyid\",\"AccessKeySecret\":\"temp_accesskeysecret\"}
```

# 金鑰使用的注意事項
## 安全相關

雲賬號 AccessKey 是您訪問阿里雲 API 的金鑰，具有該賬戶完全的許可權，請您務必妥善保管！不要透過任何方式（e.g. Github）將 AccessKey 公開到外部渠道，以避免被他人利用而造成安全威脅 。強烈建議開發者遵循阿里雲安全最佳實踐 ，使用 RAM 子使用者 AccessKey 來進行 API 呼叫。
## 關於金鑰配置中 Alias 的實際思路**

在 Serverless Devs 中，除了配置雲廠商所提供的金鑰資訊之外，還需要額外進行 Alias 的設定，這裡所謂的 Alias 是指對金鑰進行的別名設定。由於 Serverless Devs 支援多金鑰的配置和管理，所以一般情況下，一個別名對應一個金鑰對。相關的最佳實踐可以是：

- 有兩個賬號，分別是阿里雲賬號和騰訊雲賬號，那麼配置金鑰的時候就可以設定別名 alibaba、tencent，在使用的時候，透過引用不同別名使用不同的金鑰，以防止每次切換金鑰的時候，進行金鑰重新配置；

- 自己擁有兩個環境的金鑰，一個是測試環境金鑰 test，一個是線上環境金鑰 release，當開發完成之後需要把業務部署到不同的環境下，可以透過指定金鑰的形式，直接進行部署，而無需因為金鑰的切換反覆進行金鑰的重新配置；

## 金鑰使用方法

在 Serverless Devs 中，金鑰的使用主要在兩個層面：

- **命令列層面：**在命令列中使用的時候，可以直接透過-a/--access 引數進行使用，例如在部署某業務的時候，可以透過 s deploy-a demo 指定使用 demo 金鑰對；

- **Yaml 配置檔案層面：**可以透過在 Yaml 中進行金鑰對的指定，例如：

![](https://intranetproxy.alipay.com/skylark/lark/0/2022/jpeg/22456429/1651822561929-1644ba44-7821-4cd4-ba23-9294661bf6df.jpeg#clientId=u18f5a091-6997-4&crop=0&crop=0&crop=1&crop=1&from=paste&id=u0ed86711&margin=%5Bobject%20Object%5D&originHeight=323&originWidth=670&originalType=url&ratio=1&rotation=0&showTitle=false&status=done&style=none&taskId=u6978e989-77ac-41eb-8208-63eeed08d39&title=)

在 Yaml 的中直接指定 access，表示整個應用都透過當前金鑰對進行部署，也可以在某個模組/業務下指定當前模組/業務使用某指定的金鑰對進行部署。
## 金鑰使用順序相關
金鑰支援多種形式的使用，也就會出現金鑰的使用的順序問題：

- 透過 -a/--access 引數指定的金鑰資訊
- 使用已經配置的 default 金鑰資訊
- 使用透過環境變數配置的 ``default_serverless_devs_access` 金鑰資訊
- 不使用金鑰資訊 / 進入金鑰資訊配置引導

具體的流程圖為：

![](https://intranetproxy.alipay.com/skylark/lark/0/2022/png/22456429/1651822562206-fe3372a3-7a3f-4f91-977e-6c52efeec728.png#clientId=u18f5a091-6997-4&crop=0&crop=0&crop=1&crop=1&from=paste&id=ucf7c69b8&margin=%5Bobject%20Object%5D&originHeight=199&originWidth=900&originalType=url&ratio=1&rotation=0&showTitle=false&status=done&style=none&taskId=u49dc25cc-d01d-429e-ae59-e35c4b59019&title=)
## 金鑰的其他相關操作

在 Serverless Devs 中，除了配置金鑰之外還包括金鑰的修改、刪除和檢視，此時可以透過 s config -h 進行相關功能的檢視：

- 金鑰的檢視，可以透過 s config get -h 檢視幫助；
- 金鑰的修改，可以重新進行指定別名的金鑰的建立，並透過-f 引數，強行覆蓋；
- 金鑰的刪除，可以透過 s config delete-h 檢視幫助；
# 結語
Serverless Devs 可以透過指定格式的 Yaml 對 Serverless 應用進行描述，在 Serverless Devs 的規定中，一個 Yaml 可以被認為是一個 Serverless 應用，在下篇文章中我會為大傢俱體介紹下 Yaml 的使用規範。

最全！即學即會 Serverless Devs 基礎入門（上）

相關文章