یو محصول پاڼه وايي چې API لري، او د یوځای کولو غونډه په دوهمه پوښتنه کې ودرېږي. کوم عملیات، پر کوم شی، د چا له خوا بلل شوي، او څه بریا ګڼل کېږي؟ له محصولاتو د پرتلې مخکې د دغو څلورو ځواب ورکول معمولاً نیمګړي نوماندان لرې کوي. دا پاتې پرتله هم په داسې شي بدلوي چې یوه ازموینه یې فیصله کولی شي.

«API لري» په یو عملیات بدل کړئ

API یو لېږد دی، نه یوه وړتیا. یو REST پای ټکی، یو ځایي ساکټ او د کمانډ کرښې پوښ ټول API بلل کېدای شي، او دوی سره برابر عملیات نه وړاندې کوي.

مخکې له دې چې مستندات وګورئ، عملیات په یوه جمله ولیکئ.

د ځایي اړیکې پیلول د کاروونکي سره د پیریدونکي اړخ کړنه ده. د وسیلې پروفایل صادرول د موجودۍ سره د چمتو کولو کړنه ده. د کاروونکي لاسرسی بندول د پلټنې نښې سره اداري کړنه ده. دا درې معمولاً په بېلابېلو برخو کې، د بېلابېلو ټیمونو په ملکیت، او د بېلابېل واک سره وي.

څلور ساحې چې تړون ازموینه کېدونکی کوي

د هر عملیات لپاره څلور ساحې ډکې کړئ: شی، کړنه، بلونکی او د بریا شرط. هغه تړون چې یوه ساحه ورته ورکه وي یوازې یوه هیله ده.

جدول ټول کاري پاڼه ده:

FieldQuestionExample
ObjectWhat is being acted on?One enrolled device
ActionObserve, create, change, start, stop, or revoke?Revoke
CallerWhich identity calls it?Deployment service
SuccessWhat observable state proves it?Future sign-in denied

د بریا شرط هغه ساحه ده چې خلک یې پرېږدي، او همدا فیصله کوي چې یوځای کول کار کوي که نه. خوندي شوې تنظیمات فعال تونل نه دی، او بند شوی حساب پای ته رسېدلې ناسته نه ده.

که دوه عملیات بېلابېل بلونکي ته اړتیا لري، دوی دوه یوځای کول دي. د دوی یو ځای په یوه خدمتي حساب کې اچول معمولاً له هغې اندازې ډېر واک ورکول دي چې هر یو ته اړتیا ده.

مخ په هغې پوړ سره سم کړئ چې واقعاً یې دی

د OpenVPN ټولنې د مدیریت مخ د TCP یا Unix ساکټ له لارې له ډیمون سره خبرې کوي. د هغې کمانډونه د حالت څارنه او ډیمون ته اشارې شاملې دي.

دا هغه د ډیمون کنټرول چینل جوړوي، نه کوربه شوی ګډون API یا د کاروونکو ثبت خدمت. د هغې مستنداتو په دقت سره لوستل تاسو له هغې پوړ پروت جوړولو ژغوري چې د شی مالک نه دی.

هغه مستندات دا هم وايي چې پروتوکول خپله کوډونه نه لري. څوک چې ساکټ ته ورسېږي، کولی شي ډیمون کنټرول کړي، نو د حساس کنټرول په توګه یې وګڼئ، نه د میټریک جریان. هغه له loopback یا Unix ساکټ سره وتړئ، او که لرې بلونکي ته اړتیا وي، د محدود ترتیباتو شاته یې کېږدئ. د اسانتیا لپاره انټرنېټ ته د هغې ښکاره کول کنټرول چینل په یوه پېښه بدلوي.

له بلنې وروسته چلند مشخص کړئ

منل د بشپړېدو سره یو څه نه دي. ډیمون کېدای شي د تونل له پورته کېدو مخکې راوګرځي، نو د مستند شوي بشپړېدو یا ناکامۍ پېښې ته انتظار وکړئ او هغه له خپل لېږل شوي غوښتنې سره وتړئ.

فیصله وکړئ چې که ځواب ورک شي بلونکی څه کوي. د جوړولو یا بیا نښلولو ړوند تکرارول د دې څېړنې سره یو څه نه دي چې لومړنۍ غوښتنه یې لا دمخه اغېزه کړې که نه.

د لاسرسي لرې کول لږ تر لږه درې بېلابېلې کړنې دي: راتلونکې ننوتنه بندول، یوه فعاله ناسته پای ته رسول او سند باطلول. هغه یې وغواړئ چې تګلاره واقعاً غواړي، او په تړون کې ووایاست چې کوم کوم دی. پرته له شاهد یوه بریالۍ حساب تازه کول بشپړ باطلول مه بلئ. دا توپیر د پېښې پر مهال چې ساعت ځي مهم دی.

تړون په یوه ازموینه وګورئ

کوچنی منظور شوی ازموینه باید بریا، رد، مداخله او بیا هڅه پوښي، ورپسې هغه غوښتنلیک عملیات چې باید اجازه یا رد شي.

د ډیمون کچې مخ لپاره دوه کمانډونه څارنه او اشاره تمرینوي:

echo state | nc -w 2 127.0.0.1 7505
echo signal SIGTERM | nc -w 2 127.0.0.1 7505

یوازې هغه واک ورکړئ چې عملیات یې غواړي. پټې په عادي لاګونو کې مه ساتئ، او دومره شخصي توضیحات ولیکئ چې ووایاست کوم هدف اغېزمن شو او څنګه پای ته ورسېد.

د هغې پېښې لپاره د بیا رغونې لار ولیکئ چې پخپله کنټرول API ښکته وي. هغه مخ وټاکئ چې د شی او د هغې ژوند دوره مالک دی؛ پر محصول پاڼه د اتوماتیک کولو ادعاوې بدیل نه دي.

اړوندې مقالې