Cloudflare-ը ներկայացրել է Forge-ը՝ SDK և CLI գեներացնող բաց կոդով փուլաշղթա

Cloudflare-ը ներկայացրել է Forge-ը՝ բաց կոդով, միացվող գեներացիայի փուլաշղթա, որը API-ի նկարագրերից ստեղծում է SDK, CLI, փաստաթղթեր և գրադարաններ։ Ընկերության տվյալներով՝ ցանկացած ոք կարող է տեղակայել և անվճար աշխատեցնել այն։

Նախագիծը դեռ վաղ փուլում է, սակայն արդեն գեներացնում է cf CLI-ի համար անհրաժեշտ արդյունքը։ Առաջիկա ամիսներին այն կսնուցի Cloudflare-ի API-ի փաստաթղթերն ու SDK-ները։

Ինչու Cloudflare-ը ստեղծեց Forge-ը

Cloudflare-ի API-ն ունի ավելի քան 3 500 գործողություն, իսկ դրա հետևում կանգնած հարյուրավոր ծառայություններ գրված են Rust, Go, TypeScript և Python լեզուներով։ Ամբողջ API-ի համար մեկ CLI կառուցելու համար անհրաժեշտ էր այդ մասշտաբին դիմացող գեներացիայի փուլաշղթա։

Forge-ը աշխատում է CI-ում՝ յուրաքանչյուր թիմի API-ի ռեպոզիտորիայում։ Այն ստուգում է ամեն փոփոխություն և ստեղծում CLI-ի, փաստաթղթերի ու SDK-ների նախադիտման կառուցումներ՝ ընդգծելով միայն նոր փոփոխությունները։ Մոտեցումը նման է Workers Previews-ին՝ կիրառված SDK-ների գեներացիայի վրա։

Փոխարկիչներ և շղթայական գեներացիա

Forge-ի փոխարկիչները կարելի է շղթայել՝ մեկ արդյունքից ստանալով մյուսները։ OpenAPI-ի սկզբնական նկարագիրը ներկառուցվում է TypeScript-ի SDK-ում, որից հետո ստեղծվում են cf CLI-ի և Cap'n Web-ի սպեցիֆիկացիաները։

Այսօր Forge-ը որպես մուտքային ձևաչափ աջակցում է OpenAPI-ին, սակայն նախագծված է այնպես, որ հետագայում ավելանան AsyncAPI-ն, GraphQL-ը, Cap'n Proto-ն ու Protobuf-ը։ Փոխարկիչների շնորհիվ հնարավոր է գեներացնել նաև TanStack Query-ի կապեր, Zod կամ Valibot սխեմաներ, MCP սերվերներ, վահանակներ և ամբողջական հավելվածներ։

Տարբերակավորում և բաց կոդ

Forge-ը նաև օգնում է API-ի ավելի լավ տարբերակավորմանը։ v4 API-ն ընկերության հիմնական տարբերակն է արդեն տասը տարի, և ընկերությունը մշակում է մոտեցում, որը թույլ կտա թողարկել նոր հիմնական տարբերակներ՝ չկոտրելով հին հաճախորդներն ու SDK-ները։

Նոր SDK-ներ նախատեսված են TypeScript, Rust, Python, Go, PHP և Terraform լեզուներով։ Forge-ը տարածվում է Apache 2.0 արտոնագրով։ Այն կարելի է աշխատեցնել ցանկացած նպատակով, փոփոխություններով, փակ ռեժիմով և անվճար։