CLI參考 - Application Configuration Management(Deprecated)

您可以使用ACM提供的CLI命令列工具對命名空間及命名空間中的配置進行操作，目前CLI命名工具支援Linux和Mac OS作業系統。

安裝CLI工具

請按照以下步驟安裝ACM Python SDK，CLI工具將隨之安裝。

對於Python 2.7及以上版本，運行以下安裝命令：

說明運行python -V可查看Python版本。
```
pip install acm-sdk-python
```

對於Python 2.6，運行以下安裝命令：

# 安裝setuptools
wget https://pypi.io/packages/source/s/setuptools/setuptools-33.1.1.zip
unzip setuptools-33.1.1.zip
cd setuptools-33.1.1 && sudo python setup.py install

# 如已安裝setuptools則直接運行以下命令
sudo easy_install acm-sdk-python

說明使用-h參數可獲得關於指定命令的使用協助。例如，運行acm -h可獲得關於CLI工具全部命令的使用協助。運行acm add -h可獲得關於acm add命令的使用協助。

管理類命令

管理類命令用於管理命名空間。

命令	作用	樣本	主要參數	是否必需
`acm add`	添加命名空間並為其設定別名，方便使用別名快速切換命名空間。對於已經添加過的命名空間，此命令的作用是更新該命名空間。重要此命令不會建立新的命名空間。	`acm add acm.aliyun.com:ea6135---******* -a Glffao -s '654b***n87sa=' -n foo`	endpoint:namespace_id：endpoint與命名空間的ID	namespace_id是必需的。若endpoint缺失則使用預設值acm.aliyun.com。
			-a：命名空間的AccessKey	若指定了-role（RAM角色名稱）則非必需
			-s：命名空間的SecretKey	若指定了-role（RAM角色名稱）則非必需
			-n：命名空間的別名重要別名中不可使用冒號（:）	否
			-role：阿里雲RAM角色名稱	否
`acm use`	切換當前命名空間。可使用endpoint:namespace_id或別名來指定命名空間。	`acm use acm.aliyun.com:ea6135---*********`或`acm use foo`	endpoint:namespace_id：endpoint與命名空間的ID	若指定了別名則非必需。若不指定別名，則namespace_id是必需的，若endpoint缺失則使用預設值acm.aliyun.com。
`acm use`	切換當前命名空間。可使用endpoint:namespace_id或別名來指定命名空間。		別名	若指定了endpoint:namespace_id則非必需
`acm current`	列出當前命名空間。	`acm current`	N/A	N/A
`acm show`	列出所有命名空間，即通過`acm add`命令添加的所有命名空間。	`acm show`	N/A	N/A

資料操作類命令

資料操作類命令用於操作命名空間中的配置。

說明以下命令預設作用於當前命名空間，也可以使用-n參數傳入endpoint:namespace_id或別名來指定要操作的命名空間。使用-h參數可獲得關於指定命令的使用協助。例如，運行acm -h可獲得關於CLI工具全部命令的使用協助。運行acm pull -h可獲得關於acm pull命令的使用協助。

命令	作用	樣本	主要參數	是否必需
`acm pull`	擷取一個配置並將其內容列印到Console。	`acm pull group/dataId > dest.txt`	group/data_id	data_id（ Data ID ）是必需的。若配置屬於預設 Group ，則group是可選的。
`acm push`	推送一個配置。	`cat source.txt \| acm push group/dataId`	group/data_id	data_id是必需的。若配置屬於預設Group，則group是可選的。
`acm push`	推送一個配置。	`cat source.txt \| acm push group/dataId`	標準輸入資料流中的內容（可使用管道命令）或用-f參數指定的輸入檔案。	至少需要提供這兩種輸入中的一種。若同時提供，則用-f參數指定的輸入檔案優先順序高。
`acm export`	將命名空間下的所有設定匯出到本地。	`acm export -d ./myConfigs`	-f：要匯出的 .zip壓縮檔名稱。	否。若不指定，則使用預設值`<endpoint>-<namespace_id>.zip`。
`acm export`	將命名空間下的所有設定匯出到本地。	`acm export -d ./myConfigs`	-d：將設定匯出至該目錄，目錄結構為`group/data_id`（預設Group中的配置存放於根目錄）。	否。若指定，則忽略-f參數指定的壓縮檔名稱。
`acm import`	將本地設定檔匯入到命名空間。	`acm import -d ./myConfigs`	-f：要匯入的 .zip壓縮檔名稱。	否。若不指定，則使用預設值`<endpoint>-<namespace_id>.zip`。
`acm import`	將本地設定檔匯入到命名空間。	`acm import -d ./myConfigs`	-d：從該目錄匯入配置，目錄結構為`group/data_id`（預設Group中的配置存放於根目錄）。	否。若指定，則忽略-f參數指定的檔案名稱。