در این پست، میخواهیم ببینیم که چگونه میتوانیم یک ساخت جدید در VSTS را از هر یک از کلاینتهای HTTP پرکاربردمان مانند کمانچهساز یا پستچی راهاندازی کنیم.
پیش نیازها
- برای این کار، به یک حساب VSTS فعال با امتیازات مدیریتی نیاز داریم.
- دانش قبلی از تعاریف ساخت VSTS.
- یک تعریف ساخت ساده در یک پروژه تیمی.
اگر در VSTS تازه کار هستید، لطفاً اسناد رسمی را در اینجا بررسی کنید .
من می خواهم این پست را کوتاه و دقیق بنویسم، بنابراین به جزئیات نحوه راه اندازی پروژه تیم، آپلود پایه کد و نحوه ایجاد خط لوله CI CD برای پروژه های خود نمی پردازم.
اگر میخواهید بیشتر بدانید و خط لوله CI CD را برای خدمات ASP.NET Core تنظیم کنید، لطفاً از وبلاگهای قبلی من در اینجا دیدن کنید .
اکنون که ما یک راه اندازی کامل با پروژه Team و تعاریف ساخت داریم، بیایید به سمت مصرف VSTS API که توسط Team Service در معرض دید قرار می گیرند، حرکت کنیم.
REST API روی VSTS و TFS
VSTS تعداد زیادی API را برای مجموعههای مختلف عملیات، مانند -
- حساب و نمایه
- پروژه ها و تیم ها
- کار (چابک)
- ساختن
- کنترل نسخه
- امنیت… و غیره
بسیاری از ویژگی های دیگر وجود دارد که از طریق REST API برای VSTS در معرض دید قرار می گیرند. برای اطلاع از همه ویژگی های جالب، لطفاً از اسناد رسمی آنها در اینجا دیدن کنید .
در این پست، نحوه مصرف Build API و راهاندازی یا صف کشیدن یک بیلد را در چند مرحله ساده با استفاده از هر سرویس گیرنده HTTP REST که در دستگاه محلی شما موجود است، خواهیم دید که در مورد ما، ما از Fiddler استفاده خواهیم کرد.
مرحله 1 ایجاد نشانه مجوز:
برای فراخوانی API های VSTS، ما به برخی از حالت های احراز هویت برای حساب خود نیاز داریم. ساده ترین راه برای انجام این کار، ایجاد یک PAT (Token دسترسی شخصی) از پورتال VSTS است. اگرچه برای مشکلات کوچک و موارد استفاده آسان و مؤثر است، برای سناریوهای تجاری مناسب، لطفاً مستندات رسمی را برای دستورالعمل توسط تیم VSTS در اینجا بررسی کنید .
برای این نسخه ی نمایشی، ما با ایجاد یک PAT و نحوه استفاده از آن برای احراز هویت تماس های API خود ادامه خواهیم داد.
برای تولید PAT ابتدا باید وارد اکانت VSTS خود شده و سپس از گوشه سمت راست بالا در قسمت پروفایل، مانند تصویر زیر به Security بروید.
در برگه امنیت، نشانه های دسترسی شخصی را انتخاب کنید که لیستی از PAT های ایجاد شده قبلی را نشان می دهد. حال برای تولید توکن جدید باید روی Add کلیک کنیم و سپس توکن خود را توضیح دهیم تا بعدا شناسایی شود و تاریخ انقضا آن را انتخاب کرده و نقش ها (scopes) آن را انتخاب کنیم.
توجه داشته باشید