Alibaba Cloud CLI, Codeup (kod yönetimi), Flow (işlem hatları), Packages (yapıt yönetimi) gibi Apsara DevOps hizmetlerini yönetmek için OpenAPI üzerine kurulmuş bir komut satırı aracıdır. Bu hızlı başlangıç kılavuzunda Alibaba Cloud CLI'nin nasıl kurulacağı, Apsara DevOps kimlik bilgilerinin nasıl yapılandırılacağı ve Yunxiao OpenAPI işlemlerinin nasıl çağrılacağı anlatılmaktadır. Örnekte, işlem hattı etiket grubu ayrıntılarını almak için flow-get-flow-tag-group komutu kullanılır.
Önkoşullar
Bir Alibaba Cloud hesabı
Bir Apsara DevOps (Yunxiao) kuruluşu; Bölge sürümü
Yunxiao konsolunda oluşturduğunuz bir Yunxiao kişisel erişim belirteci. Talimatlar için bkz. Kişisel erişim belirteci alma.
(İsteğe bağlı) Alibaba Cloud CLI konusunda yeniyseniz bkz. Alibaba Cloud CLI nedir.
Adım 1: Alibaba Cloud CLI'yi yükleyin
İşletim sisteminize göre Alibaba Cloud CLI'yi yükleyin:
Windows: Windows'ta CLI'yı yükleyin
macOS: macOS'ta CLI'yı yükleyin
Alibaba Cloud CLI zaten yüklüyse yeni Yunxiao OpenAPI'yi destekleyen bir sürüme yükseltmek için aşağıdaki komutu çalıştırarak Yunxiao eklentisini güncelleyin:
aliyun plugin install --names aliyun-cli-devopsAyrıca yerel kurulum yapmadan Alibaba Cloud CLI komutlarını çalıştırmak için Cloud Shell kullanabilirsiniz. Daha fazla bilgi için bkz. Cloud Shell nedir.
Adım 2: Yunxiao CLI'yi yapılandırın
Apsara DevOps kimlik sistemi diğer Alibaba Cloud hizmetlerinden farklıdır. Yunxiao, kimlik bilgilerini depolamak için profilleri (AccessKey çiftleri) kullanmaz. Bunun yerine Yunxiao konsolunda bir kişisel erişim belirteci oluşturun ve bunu aliyun configure aracılığıyla değil ortam değişkenleri veya komut satırı parametreleri üzerinden iletin.
Kişisel erişim belirteci alma
Yunxiao API işlemlerine erişmek ve HTTP üzerinden Git işlemleri yapmak için kişisel erişim belirteci kullanabilirsiniz. Daha fazla bilgi için bkz. Kişisel erişim belirteci alma.
Belirteç oluştururken minimum gerekli API izinlerini seçin ve makul bir geçerlilik süresi ayarlayın. Kalıcı bir belirteç oluşturmayın.
Belirteç yalnızca ilk oluşturulduğunda görüntülenir. Belirteci daha sonra tekrar görüntüleyemezsiniz. Belirteci güvenli bir yerde saklayın.
Belirteçleri komut satırında düz metin olarak iletmeyin. Ortam değişkenleri kullanmanızı öneririz.
Bir belirteç sızdırılırsa derhal silin.
Kimlik bilgilerini yapılandırma
Yunxiao CLI iki kimlik bilgisi yapılandırma yöntemini destekler: ortam değişkenleri ve komut satırı parametreleri.
Yöntem 1: Ortam değişkenlerini kullanma (önerilen)
Yunxiao CLI aşağıdaki ortam değişkenlerini kullanır:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Bölge sürümü örneği:
export ALIBABA_CLOUD_YUNXIAO_ACCESS_TOKEN=<your-personal-access-token>
export ALIBABA_CLOUD_YUNXIAO_API_BASE_URL=<your-api-base-url>Yöntem 2: Komut satırı parametrelerini kullanma
Kimlik bilgilerini her komutta parametre olarak da iletebilirsiniz:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Bölge sürümü örneği:
aliyun devops flow-get-flow-tag-group --id 0 \
--api-base-url=<your-api-base-url> \
--yunxiao-access-token=<your-personal-access-token>Yapılandırmanızı doğrulayın
Yunxiao CLI eklentisinin kullanılabilir olduğunu doğrulamak için aşağıdaki komutu çalıştırın:
aliyun devops versionKomut hata olmadan sürüm bilgilerini döndürürse ortamınız kullanıma hazırdır.
Adım 3: API işlemlerini çağırın
Örnek 1: Kullanılabilir komutları listeleme
Tüm Yunxiao CLI komutlarını görüntülemek için aşağıdaki komutu çalıştırın:
aliyun devops --helpAşağıdaki çıktı döndürülür (kısmi):
Description: Aliyun CLI plugin for yunxiao operations.
Usage: aliyun devops <command> [flags]
Available Commands:
app-stack-create-application Create an application
app-stack-list-applications List applications
codeup-create-repository Create a code repository
codeup-list-repositories List code repositories
flow-create-pipeline Create a pipeline
flow-list-pipelines List pipelines
flow-get-flow-tag-group Get pipeline tag group details
projex-search-projects Search projects
projex-search-workitems Search work items
...Yunxiao CLI aşağıdaki modülleri kapsar:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Uluslararası site'de (alibabacloud.com) yalnızca Codeup, Flow ve Packages modülleri kullanılabilir. projex-*, test-hub-*, app-stack-* ve insight-* ön eklerine sahip komutlar Uluslararası site'de desteklenmez.
Örnek 2: İşlem hattı etiket grubu ayrıntılarını alma
Aşağıdaki örnek, işlem hattı etiket grubu ayrıntılarını almak için flow-get-flow-tag-group komutunu çağırır.
# Region edition (environment variables)
export ALIBABA_CLOUD_YUNXIAO_ACCESS_TOKEN=<your-personal-access-token>
export ALIBABA_CLOUD_YUNXIAO_API_BASE_URL=<your-api-base-url>
aliyun devops flow-get-flow-tag-group --id 0Örnek yanıt:
{
"id": 0,
"name": "Environment Tags",
"tags": [
{
"id": 1,
"name": "Production",
"color": "#FF6B6B"
},
{
"id": 2,
"name": "Staging",
"color": "#4ECDC4"
}
]
}Bir Yunxiao OpenAPI işlemini çağırırken hata alırsanız aşağıdaki yaygın nedenleri kontrol edin:
Geçersiz veya süresi dolmuş belirteç — Kişisel erişim belirtecinizin geçerli olduğundan ve gerekli izinlere sahip olduğundan emin olun.
Yanlış uç nokta — Sürümünüz için doğru API uç noktasını kullandığınızdan emin olun.
Gerekli parametrelerin eksik olması — Merkez sürümü
--organization-idparametresini gerektirir. Bölge sürümü--api-base-urlparametresini gerektirir.
Daha fazla örnek
Aşağıdaki örneklerde yaygın Yunxiao CLI işlemleri gösterilmektedir.
Kod depolarını listeleme
aliyun devops codeup-list-repositories --page 1 --per-page 20Projeleri arama
aliyun devops projex-search-projects --page 1 --per-page 10İşlem hatlarını listeleme
aliyun devops flow-list-pipelines --page 1 --per-page 20Uygulamaları listeleme
aliyun devops app-stack-list-applications --pagination '{"page":1,"perPage":20}' --order-by createdAtJMESPath kullanarak çıktıyı filtreleme
aliyun devops codeup-list-repositories --cli-query 'result[].{name:name,id:id}'