Տեղակայեք ստատիկ կայք ձեր սեփական Azure Static Web Apps հաշվում

Ինչ է տալիս ձեզ դրա միացումը

Ձեր սեփական Azure Static Web Apps հաշիվը միացնելը թույլ է տալիս հրապարակել ստատիկ կայք ձեր Azure Static Web Apps հաշվում՝ ձեր Zinn® վահանակից: Դուք եք տնօրինում նախագիծն ու վճարումները. մենք հոգ ենք տանում տեղակայման (deploy), հատուկ դոմեյնի և DNS գրառումների մասին:

Նախքան սկսելը

Azure բաժանորդագրություն, ռեսուրսների խումբ կայքերի համար և կոդը պարունակող միացված GitHub, GitLab կամ Bitbucket հաշիվ — Azure Static Web Apps-ը կառուցում է ռեպոզիտորիայից: Azure-ի անվճար պլանը թույլատրում է առևտրային օգտագործում և երկու հատուկ դոմեյն մեկ հավելվածի համար:

1. Ստեղծեք բանալին Azure Static Web Apps-ում

Azure-ն այն անվանում է service principal: Microsoft Entra admin center-ում բացեք Entra ID → App registrations → New registration, տվեք դրան անուն և սեղմեք Register: Հավելվածի ընդհանուր տեսքի (overview) էջում պատճենեք Application (client) ID-ն և Directory (tenant) ID-ն: Այնուհետև բացեք Certificates & secrets → Client secrets → New client secret, ընտրեք տևողությունը և սեղմեք Add — պատճենեք գաղտնաբառի (secret) արժեքն անմիջապես, Azure-ն այն ցուցադրում է միայն մեկ անգամ:

Azure պորտալում բացեք ռեսուրսների այն խումբը, որը ցանկանում եք, որ մենք օգտագործենք, ապա՝ Access control (IAM) → Add → Add role assignment: Ընտրեք Contributor դերը, նշանակեք այն User, group, or service principal-ին, որոնեք հավելվածն ըստ անվան և սեղմեք Review + assign: Գրանցեք ռեսուրսների խմբի անվանումը և Subscription ID-ն, որին այն պատկանում է (պորտալում որոնեք Subscriptions):

2. Միացրեք այն այստեղ

Ձեր վահանակում բացեք Integrations բաժինը և ընտրեք Connect an account: Որպես խումբ ընտրեք Static hosting (Netlify, Vercel), իսկ որպես հաշիվ՝ Azure Static Web Apps, լրացրեք Client ID, Client secret, Tenant ID, Subscription ID և Resource group դաշտերը, ապա սեղմեք Connect account:

Մենք փորձարկում ենք ձեր տեղադրած տվյալները նախքան որևէ բան պահպանելը: Չաշխատող բանալին երբեք չի պահպանվում, իսկ պատասխանում նշվում է, թե ինչն էր սխալ: Աշխատող բանալին պահվում է գաղտնագրված մեր գաղտնիքների պահոցում (secrets vault) — երբեք ոչ մեր տվյալների բազայում — և այլևս երբեք չի ցուցադրվում, նույնիսկ ձեզ:

Ինչ է տեղի ունենում հետո

• Երբ ստեղծում կամ տեղափոխում եք ստատիկ կայք, այս հաշիվը հայտնվում է որպես տեղակայման

թիրախ: Azure Static Web Apps-ը կառուցում է ռեպոզիտորիայից — այն վերբեռնված կառուցվածքն ընդունելու որևէ եղանակ չունի — հետևաբար կայքի կոդը պետք է գա միացված GitHub, GitLab կամ Bitbucket ռեպոզիտորիայից: Եթե դեռ չեք միացրել, նախ միացրեք դրանցից մեկը:

• Մենք ստեղծում ենք ծառայությունը ձեր հաշվում, ուղղորդում այն դեպի ռեպոզիտորիան, կցում ձեր հատուկ դոմեյնը

և գործարկում տեղակայումները: Դոմեյնի էջը ցույց է տալիս ցանկացած DNS գրառում, որն անհրաժեշտ է Azure Static Web Apps-ին:

• Օգտագործումը և գանձումները գտնվում են ձեր հաշվում և տեսանելի են մատակարարի ձեր իսկ վահանակում:
• Հիմնական (apex) դոմեյնը հաստատվում է TXT գրառման միջոցով, իսկ ենթադոմեյնը՝ իր CNAME-ի. դոմեյնի էջը ցույց է տալիս,

թե դրանցից որն է անհրաժեշտ ձեր դոմեյնին:

Եթե այն չի միանում

Azure-ը մերժել է service principal-ը: Կա՛մ լրացել է client secret-ի ժամկետը — դրանք միշտ էլ լրանում են՝ ըստ ձեր ընտրած տևողության — կա՛մ հավելվածն այլևս չունի Contributor դեր ռեսուրսների խմբի վրա: Երկու հաղորդագրություններն էլ նման են իրար, ուստի նոր գաղտնաբառ ստեղծելուց առաջ ստուգեք դերի նշանակումը:

Ոչինչ չի գտնվել: Ստուգեք, որ Subscription ID-ն և Resource group-ը լինեն նրանք, որոնց վրա նշանակել եք դերը, և որ Tenant ID-ն լինի այն գրացուցակը, որում գրանցված է հավելվածը:

Հաղորդվում է, որ բանալին մերժվել է: Գրեթե միշտ երեք պատճառներից մեկն է՝ բացատ կամ տողադարձ, որը պատճենվել է դրա հետ միասին, ժամկետանց բանալի կամ բանալի, որը չեղարկվել կամ վերաթողարկվել է ձեր կողմից այն պատճենելուց հետո: Ստեղծեք նորը և կրկին տեղադրեք:

Այն միանում է, բայց ավելի ուշ ինչ-որ բան ձախողվում է: Բանալին անցնում է նույնականացումը, բայց չունի այն թույլտվությունը, որն անհրաժեշտ է գործողությանը: Ստեղծեք նոր բանալի՝ վերը նշված թույլտվություններով, ապա անջատեք հին միացումը և միացրեք նոր բանալին:

Անջատում

Բացեք Integrations բաժինը, գտեք հաշիվը և սեղմեք Disconnect: Դա անմիջապես ջնջում է պահպանված բանալին: Այն ամենը, ինչ օգտագործում էր այն, կդադարի աշխատել իր հաջորդ գործողության ժամանակ, իսկ դրանից կախված էկրանները կտեղեկացնեն այդ մասին՝ լուռ ձախողվելու փոխարեն:

Անջատումը չի չեղարկում այն, ինչ արդեն արվել է — գրառումները, տեղակայումները կամ կարգավորումները, որոնք մենք փոփոխել ենք ձեր հաշվում, մնում են այնպես, ինչպես կան: Եթե կարծում եք, որ բանալին ինքնին կարող է արտահոսած լինել, չեղարկեք այն նաև մատակարարի մոտ. անջատումը հեռացնում է մեր օրինակը, ոչ թե նրանցը: