Una breve panoramica sull’API Kinsta<\/h2>\n
In breve, l’API di Kinsta<\/a> permette di interagire in modo programmatico con i vostri siti e ambienti sulla nostra piattaforma. Forniamo una serie di endpoint che \u00e8 possibile utilizzare per eseguire diverse operazioni, come la creazione di nuovi siti WordPress, la clonazione di siti esistenti, la gestione dei backup e altro ancora.<\/p>\n Questa API RESTful<\/a> offre molti vantaggi ai vostri progetti di sviluppo grazie alle sue caratteristiche e funzionalit\u00e0 chiave:<\/p>\n Per saperne di pi\u00f9 su ci\u00f2 che \u00e8 disponibile nell’API di Kinsta, consultate la documentazione dedicata<\/a>. Tuttavia, nel resto del post vedremo molti esempi, dopo aver approfondito i vantaggi che l’API pu\u00f2 offrire.<\/p>\n Naturalmente amiamo la dashboard di MyKinsta<\/a> per il livello di dettagli, la splendida interfaccia e il livello di controllo che offre. Tuttavia, troverete la maggior parte delle funzionalit\u00e0 anche all’interno dell’API di Kinsta. Se siete sviluppatori, potrebbe essere interessante per voi per diversi motivi:<\/p>\n Ma basta parlare: passiamo all’uso dell’API di Kinsta. Inizieremo con gli endpoint che funzionano bene per lo sviluppo e poi li utilizzeremo in un flusso di lavoro.<\/p>\n Sebbene l’API di Kinsta offra molti endpoint, alcuni saranno pi\u00f9 utilizzati di altri. Per lo sviluppo, tornerete spesso su alcuni di essi:<\/p>\n Questi endpoint coprono le funzionalit\u00e0 principali di cui avrete bisogno per la maggior parte dei flussi di sviluppo. Tuttavia, ce ne sono altri che possono integrare gli endpoint che usate spesso. Ad esempio, quelli che gestiscono database, distribuzione, caching e Content Delivery Network (CDN) hanno tutti un ruolo da svolgere.<\/p>\n Nel resto dell’articolo spiegheremo come utilizzare l’API di Kinsta per lo sviluppo reale. Nella sezione dei commenti alla fine del post, potrete anche condividere i vostri esempi in cui pensate che l’API Kinsta possa essere utile: ci piacerebbe leggerli!<\/p>\n Proviamo a illustrare come si pu\u00f2 utilizzare l’API di Kinsta nella pratica. Ci sono molti modi per sviluppare WordPress, quindi vedremo come un’agenzia di web design potrebbe utilizzare l’API in un flusso di lavoro. In generale, questo comporta alcune fasi:<\/p>\n Nonostante l’API di Kinsta sia molto presente in questo post, il nostro primo passo non ne avr\u00e0 bisogno. Iniziamo a configurare l’ambiente di sviluppo locale, poi passiamo agli elementi programmatici per lo staging e la produzione.<\/p>\n L’ambiente locale deve essere solido e ogni sviluppatore avr\u00e0 il suo approccio preferito<\/a>. Naturalmente, la nostra scelta sar\u00e0 DevKinsta<\/a>.<\/p>\n Questo pu\u00f2 semplificare il processo di configurazione dell’ambiente locale, soprattutto se si utilizza l’hosting di Kinsta. DevKinsta \u00e8 gratuito e offre molte funzionalit\u00e0 che altri strumenti simili non possono offrire:<\/p>\n DevKinsta offre anche una serie di strumenti per gli sviluppatori. Ad esempio, \u00e8 possibile attivare Xdebug<\/a> con un solo clic e modificare i file di configurazione php.ini<\/strong> e Nginx dalla schermata delle impostazioni:<\/p>\n La configurazione e l’utilizzo di DevKinsta esulano dallo scopo di questo post, poich\u00e9 vogliamo concentrarci sull’API di Kinsta. Tuttavia, abbiamo una documentazione completa<\/a> sull’avvio dell’ambiente locale che dovrebbe essere una lettura obbligatoria.<\/p>\n A questo punto, avrete un ambiente di sviluppo locale (magari DevKinsta!) e un sito abbastanza completo per passare alla fase successiva. La creazione di un ambiente di staging utilizza sia le funzionalit\u00e0 di DevKinsta che quelle dell’API di Kinsta. Vediamo come procedere in pochi passi.<\/p>\n Per prima cosa, cercate di creare un nuovo ambiente di staging<\/a> con l’API di Kinsta. Potete farlo all’interno di DevKinsta attraverso i link alla dashboard MyKinsta:<\/p>\n Tuttavia, l’API di Kinsta ha degli endpoint<\/a> che coprono ogni caso d’uso pratico. Ad esempio, si possono creare siti e ambienti sia semplici che popolati. In questo caso, vi consigliamo di utilizzare ambienti semplici, cos\u00ec da stare tranquilli che il sito locale si sposter\u00e0 in una posizione “fresca”.<\/p>\n Per farlo, sar\u00e0 prima necessario configurare un nuovo sito WordPress<\/a> su Kinsta utilizzando l’endpoint appropriato:<\/p>\n Una volta creato il sito, potete ottenere un elenco di siti<\/a> passando l’ID dell’azienda:<\/p>\n Una volta completata questa operazione, si pu\u00f2 passare a creare l’ambiente di staging<\/a> utilizzando l’ID del sito giusto:<\/p>\n Vi consigliamo anche di creare un database per il sito di staging. Tra poco lo sovrascriverete con il vostro database locale, ma inizializzare un placeholder \u00e8 una buona pratica:<\/p>\n A seconda della configurazione, potrebbe essere necessario aggiungere un nuovo dominio<\/a> a Kinsta, cosa che \u00e8 possibile fare attraverso un semplice endpoint. Tuttavia, una volta che lo staging \u00e8 stato configurato, \u00e8 possibile cercare di inviarvi le modifiche locali.<\/p>\n L’esatto processo di push delle modifiche allo staging dipender\u00e0 dalla configurazione e dai vostri strumenti specifici. Un approccio generale e tipico potrebbe essere il seguente:<\/p>\n Non ci occuperemo del controllo di versione<\/a> in questa sede, ma DevKinsta offre dei pratici strumenti per aiutarvi a inviare le modifiche al vostro hosting Kinsta:<\/p>\n In questo modo potrete scegliere l’ambiente da tutto il vostro server di hosting. Una volta fatto questo, potete anche scegliere di inviare il vostro database – un’altra cosa che non molti strumenti di sviluppo locale permettono di fare:<\/p>\n Una volta popolato l’ambiente di staging di Kinsta, l’API vi torner\u00e0 utile. Ad esempio, potete creare uno script ed eseguire un backup iniziale, che necessita solo di un ID ambiente e di un tag:<\/p>\n Se volete, potete anche installare altri temi e plugin<\/a> in questa fase. A questo punto, il nostro utilizzo di DevKinsta termina perch\u00e9 da qui in poi potrete distribuire il vostro sito utilizzando l’API di Kinsta.<\/p>\n Prima di eseguire il push delle modifiche alla produzione<\/a>, dovrete svolgere alcune operazioni cruciali, tutte con l’API di Kinsta:<\/p>\n A questo punto, dovrete testare completamente il vostro sito<\/a> in fase di staging e ottenere l’approvazione del vostro cliente. A questo punto, potete pensare alla distribuzione. Kinsta offre un paio di opzioni per farlo:<\/p>\n Naturalmente ci concentreremo sulla seconda opzione, in quanto consente un flusso di lavoro pi\u00f9 automatizzato e snello.<\/p>\n L’API di Kinsta offre diversi modi per eseguire il push un ambiente. Potete eseguire il push dell’ambiente di staging<\/a> a quello di produzione o clonarlo<\/a>.<\/p>\n In ogni caso, \u00e8 una buona idea creare un altro backup di ogni ambiente che state gestendo, in modo da poter recuperare se qualcosa va storto.<\/p>\n L’API di Kinsta \u00e8 un modo potente per apportare modifiche programmatiche ai vostri siti e ambienti. Per questo motivo, dovrete fare attenzione quando la utilizzate, perch\u00e9 se qualcosa va storto, sar\u00e0 vostra responsabilit\u00e0 ripararlo.<\/p>\n Per questo motivo, ecco alcuni suggerimenti, trucchi e best practice da integrare nel vostro flusso di lavoro di sviluppo:<\/p>\n Questo aspetto \u00e8 molto pi\u00f9 importante quando si tratta di collaborare con i team e di automatizzare il lavoro. La nostra ultima sezione analizza questo aspetto in modo pi\u00f9 dettagliato.<\/p>\n Uno dei maggiori vantaggi dell’utilizzo dell’API di Kinsta \u00e8 la possibilit\u00e0 di automatizzare le attivit\u00e0 ripetitive del vostro flusso di lavoro di sviluppo. Scrivendo script o integrando con altri strumenti, potete ottimizzare i processi e risparmiare tempo.<\/p>\n Per semplificare completamente il vostro flusso di lavoro, potete automatizzare il passaggio dallo staging alla produzione integrando l’API Kinsta con la vostra pipeline CI\/CD. Questo pu\u00f2 essere un processo complesso e soggettivo che pu\u00f2 cambiare da progetto a progetto. Ad esempio, ecco un esempio di flusso di lavoro per uno script adatto:<\/p>\n Questo \u00e8 il grande vantaggio dell’API di Kinsta. Potete automatizzare quasi tutti gli aspetti del vostro flusso di lavoro per garantire distribuzioni coerenti e affidabili. Potete fare molto di pi\u00f9 anche con questo:<\/p>\n Il bello dell’API di Kinsta \u00e8 il controllo che potete ottenere con i metodi programmatici. Il campo di applicazione \u00e8 molto ampio e potreste persino creare dashboard personalizzati<\/a> che mostrino alcune di queste metriche o opzioni per un flusso di sviluppo ancora pi\u00f9 fluido.<\/p>\n\n
Perch\u00e9 i workflow di sviluppo possono trarre vantaggio dalle API di Kinsta<\/h2>\n
![\"The](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/05\/php-performance-with-lefthand-menu.png\")
\n
Gli endpoint dell’API di Kinsta per lo sviluppo<\/h2>\n
\n
Un caso d’uso reale: portare avanti lo sviluppo di un sito<\/h2>\n
\n
1. Impostare un ambiente di sviluppo locale<\/h3>\n
![](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/04\/devkinsta-splash.png\")
\n
![\"L'editor](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/04\/nginx-config.png\")
2. Gestire gli ambienti di sviluppo locali e di staging<\/h3>\n
Creare un ambiente di staging<\/h4>\n
![](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/04\/create-environment.png\")
const resp = await fetch(\n `https:\/\/api.kinsta.com\/v2\/sites\/plain`,\n {\n method: 'POST',\n headers: {\n 'Content-Type': 'application\/json',\n Authorization: 'Bearer <YOUR_TOKEN_HERE>'\n },\n body: JSON.stringify({\n company: '54fb80af-576c-4fdc-ba4f-b596c83f15a1',\n display_name: 'First plain site',\n region: 'us-central1'\n })\n }\n);\n\nconst data = await resp.json();\n<\/code><\/pre>\n\u2026\n \"company\": {\n \"sites\": [\n {\n \"id\": \"54fb80af-576c-4fdc-ba4f-b596c83f15a1\",\n \"name\": \"firstsite\",\n \"display_name\": \"First site\",\n \"status\": \"live\",\n \"siteLabels\": [\n {\n \"id\": \"54fb80af-576c-4fdc-ba4f-b596c83f15a1\",\n \"name\": \"Do not remove\"\n\u2026\n<\/code><\/pre>\nconst siteId = 'YOUR_site_id_PARAMETER';\nconst resp = await fetch(\n `https:\/\/api.kinsta.com\/v2\/sites\/${siteId}\/environments\/plain`,\n {\n method: 'POST',\n headers: {\n 'Content-Type': 'application\/json',\n Authorization: 'Bearer <YOUR_TOKEN_HERE>'\n },\n body: JSON.stringify({\n display_name: 'staging',\n is_premium: false\n })\n }\n);\n\nconst data = await resp.json();\n<\/code><\/pre>\n\u2026\n {\n method: 'POST',\n headers: {\n 'Content-Type': 'application\/json',\n Authorization: 'Bearer <YOUR_TOKEN_HERE>'\n },\n body: JSON.stringify({\n company_id: '54fb80af-576c-4fdc-ba4f-b596c83f15a1',\n location: 'us-central1',\n resource_type: 'db1',\n display_name: 'test-db',\n db_name: 'test-db',\n db_password: 'example-password',\n db_user: 'example-user',\n type: 'postgresql',\n version: '15'\n })\n }\n);\n\u2026\n<\/code><\/pre>\nSincronizzare le modifiche da locale a staging<\/h4>\n
\n
![\"La](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/04\/push-to-kinsta.png\")
![](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/04\/devkinsta-database.png\")
{\n method: 'POST',\n headers: {\n 'Content-Type': 'application\/json',\n Authorization: 'Bearer <YOUR_TOKEN_HERE>'\n },\n body: JSON.stringify({\n tag: 'my-awesome-backup'\n })\n }\n);\n<\/code><\/pre>\n3. Passare le modifiche dallo staging alla produzione<\/h3>\n
\n
\n
Usare l’API per distribuire le modifiche<\/h4>\n
const siteId = 'YOUR_site_id_PARAMETER';\nconst resp = await fetch(\n `https:\/\/api.kinsta.com\/v2\/sites\/${siteId}\/environments`,\n {\n method: 'PUT',\n headers: {\n 'Content-Type': 'application\/json',\n Authorization: 'Bearer <YOUR_TOKEN_HERE>'\n },\n body: JSON.stringify({\n source_env_id: '54fb80af-576c-4fdc-ba4f-b596c83f15a1',\n target_env_id: '54fb80af-576c-4fdc-ba4f-b596c83f15a1',\n push_db: true,\n push_files: true,\n run_search_and_replace: true\n })\n }\n);\n\nconst data = await resp.json();\n<\/code><\/pre>\nBest practice e suggerimenti per l’utilizzo dell’API di Kinsta<\/h2>\n
\n
Automatizzare il flusso di lavoro di sviluppo<\/h2>\n
\n
\n
Riepilogo<\/h2>\n