Le funzionalit\u00e0 dell’API di Kinsta<\/h2>\n
L’API di Kinsta<\/a> \u00e8 il modo programmatico per interagire con il vostro server Kinsta. Offriamo molti endpoint per coprire vari modi di gestire i siti, come ad esempio lavorare con gli ambienti, i temi e i plugin di WordPress, le metriche delle applicazioni e altro ancora.<\/p>\n Ci\u00f2 si estende anche ai database attraverso la tipica architettura CRUD<\/a>:<\/p>\n Nel complesso, \u00e8 possibile sfruttare questi endpoint e iniziare a semplificare l’intero flusso di lavoro della gestione dei database. In seguito, esploreremo questo aspetto in modo pi\u00f9 dettagliato. Per prima cosa, parliamo del perch\u00e9 usare l’API di Kinsta per gestire i database.<\/p>\n Ovviamente non forniremmo un’API dedicata alla gestione dei database<\/a> senza che questa offra alcuni vantaggi interessanti rispetto alla dashboard MyKinsta. Entrambe possono essere inserite nel vostro flusso di lavoro, anche se l’API di Kinsta offre alcuni modi specifici per sbloccare nuove possibilit\u00e0.<\/p>\n Uno dei principali vantaggi della gestione dei database<\/a> tramite l’API di Kinsta \u00e8 la possibilit\u00e0 di snellire i passaggi che normalmente si compiono. Utilizzando la dashboard MyKinsta, avete gi\u00e0 un flusso di lavoro efficiente. Ad esempio, ogni sito WordPress<\/a> d\u00e0 accesso al database del vostro sito tramite phpMyAdmin<\/a>:<\/p>\n Ci\u00f2 offre un’interfaccia familiare per apportare modifiche. Per le applicazioni, la schermata Database<\/strong> di MyKinsta sar\u00e0 il vostro punto di riferimento:<\/p>\n Tuttavia, \u00e8 possibile saltare tutti questi passaggi utilizzando i nostri endpoint API. Se gi\u00e0 gestite altri servizi programmatici per il vostro sito, questo dovrebbe essere un gioco da ragazzi. Il tempo che risparmierete automatizzando questo flusso di lavoro potrebbe avere un impatto positivo sulla vostra efficienza.<\/p>\n Come per tutti gli endpoint dell’API di Kinsta, \u00e8 possibile automatizzare attivit\u00e0 che altrimenti richiederebbero l’accesso alla dashboard di MyKinsta. Parleremo pi\u00f9 avanti delle opportunit\u00e0 di integrazione. In breve, se gi\u00e0 utilizzate strumenti e script esistenti, l’automazione della gestione del vostro database pu\u00f2 diventare parte di quel processo.<\/p>\n Ad esempio, potreste voler creare un nuovo database ogni volta che create un nuovo sito. Potreste impostare dei criteri predefiniti all’interno del codice, degli strumenti e degli script per eliminare i database in modo automatico. Anche i flussi di lavoro che incorporano lo scaling delle risorse<\/a> potrebbero trarre vantaggio da questo aspetto, dato che \u00e8 possibile aggiornare il tipo di risorsa di un database.<\/p>\n Come nel caso di una razionalizzazione mirata, l’automazione del flusso di lavoro avr\u00e0 un ulteriore impatto sul tempo (e sulle spese) che dedicate alla gestione dei database.<\/p>\n Le API, in generale, offrono un modo eccellente per integrarsi con quasi tutti gli altri strumenti e piattaforme disponibili, anche quando non esistono API pronte all’uso. Potete utilizzare servizi come Zapier<\/a> o If This Then That (IFTTT)<\/a> per collegare tra loro strumenti di cui il vostro server Kinsta potrebbe far parte.<\/p>\n In effetti, molte configurazioni richiedono l’integrazione di altri servizi per un’esperienza ottimale. Considerate le vostre pipeline di integrazione e distribuzione continua (CI\/CD)<\/a> che utilizzano TeamCity, Travis CI o Buddy<\/a>. L’API Kinsta, come parte della vostra catena di strumenti, pu\u00f2 aiutarvi a creare un flusso di lavoro coeso dallo sviluppo alla produzione.<\/p>\n Nelle prossime sezioni tratteremo i diversi metodi e le richieste che l’API Kinsta mette a disposizione. Alla fine del post, vedremo come utilizzare le informazioni ottenute in alcuni scenari di esempio.<\/p>\n L’utilizzo dell’endpoint Per accedere all’endpoint \u00c8 possibile creare una chiave API nella schermata Impostazioni azienda > Chiavi API<\/strong> della dashboard di MyKinsta.<\/p>\n Per accedere alla maggior parte degli endpoint \u00e8 necessario anche l’ID azienda<\/strong>. Si tratta essenzialmente dell’ID del server, che trovate nella barra degli strumenti del browser quando ci si connette alla dashboard di MyKinsta:<\/p>\n Il flusso di lavoro tipico quando si utilizzano gli endpoint dell’API di Kinsta consiste nel convalidare la chiave API, recuperare i dati associati all’ID dell’azienda, recuperare i dati associati all’ID del sito ed elaborare tali dati. Questa fase finale richiede che forniate i parametri giusti per la richiesta.<\/p>\n Naturalmente, questi parametri variano a seconda di ci\u00f2 che volete ottenere. Nel corso della gestione dei database, ci occuperemo di questi parametri.<\/p>\n La creazione di un database richiede il maggior numero di operazioni tra tutte le richieste che tratteremo qui, ma \u00e8 comunque un’operazione semplice. Si tratta di inviare una richiesta all’indirizzo Una volta definiti questi parametri, procedete con il convalidare la vostra chiave API e creare il vostro database:<\/p>\n Per ogni endpoint, riceverete i dati richiesti in formato JSON:<\/p>\n Se la richiesta non va a buon fine, vedrete l’informazione all’interno del JSON di ritorno:<\/p>\n Come per ogni richiesta che effettuate, dovete cercare di mantenere sicuri i dati che inviate e ricevete. La convalida della chiave API \u00e8 un modo per farlo, ma ci sono altri fattori importanti:<\/p>\n La buona notizia \u00e8 che molte di queste informazioni possono essere trasferite ad altre azioni relative all’endpoint Recuperare e cancellare i vostri database richiede pochi secondi e riutilizza gran parte del codice che avete gi\u00e0 implementato al momento della creazione dei database. La richiesta Questo restituir\u00e0 un elenco di informazioni relative ai vostri database che include dettagli sui limiti di CPU e memoria, l’hostname e la porta interna e molto altro ancora:<\/p>\n Cancellare un database \u00e8 altrettanto semplice. Inviate il metodo Tuttavia, a differenza dell’utilizzo della dashboard di MyKinsta, dovrete prestare ulteriore attenzione quando cancellate i database con l’API. In questo caso, non riceverete alcun messaggio di conferma o “buffer”. Per questo motivo, potreste anche prevedere una gestione degli errori o dei controlli per assicurarvi di voler davvero<\/em> eliminare il database per sempre.<\/p>\n Lasciamo per ultimo l’aggiornamento dei database perch\u00e9, sebbene all’apparenza sembri un’operazione semplice e limitata, questa richiesta pu\u00f2 offrire alcune opportunit\u00e0 uniche.<\/p>\n In apparenza, gli aggiornamenti offrono poche possibilit\u00e0 di modifica. Gli unici parametri che si possono modificare sono il nome del database e il suo tipo di risorsa:<\/p>\n In questo caso gli aggiornamenti del database possono inserirsi bene nell’intero flusso di lavoro di sviluppo o di gestione del sistema. Ad esempio, il database potrebbe essere un database che passa da uno stato all’altro e da un ambiente all’altro. In momenti diversi, potreste effettuare un aggiornamento che rinomini il database in base alle convenzioni del progetto, allo stato di uno sprint o a qualsiasi altra cosa vogliate.<\/p>\n Il tipo di risorsa \u00e8 un modo semplice per modificare al volo le dimensioni e le prestazioni del database. Ci\u00f2 permette di adattare il database alle variabili del progetto o alla domanda del pubblico per il vostro sito. Parleremo di questo aspetto pi\u00f9 avanti.<\/p>\n La scalabilit\u00e0 \u00e8 un elemento vitale di un sito web moderno e il vostro non dovrebbe fare eccezione. Per questo motivo, l’API di Kinsta offre il parametro resource_type<\/strong>. Quando si parla di scalabilit\u00e0 verticale<\/a>, questo parametro potrebbe essere in prima linea nella vostra strategia. Inoltre, basta una sola riga per modificare le risorse del vostro database e allocarne di pi\u00f9 o di meno:<\/p>\n Esistono otto tipi diversi tra cui scegliere e, in generale, pi\u00f9 alto \u00e8 il numero, maggiori sono le risorse allocate – quindi In questo modo potete aumentare o diminuire le risorse in modo molto rapido, a seconda delle vostre esigenze.<\/p>\n Ad esempio, se il traffico aumenta o se dovete eseguire attivit\u00e0 di database pi\u00f9 intensive, potete aumentare le risorse a un livello superiore.<\/p>\n Per estensione, potete utilizzare l’endpoint dei database<\/strong> insieme ad altri endpoint dell’API di Kinsta per creare un sistema di gestione dei database completo o incorporare tale gestione in altri flussi di lavoro.<\/p>\n Un ottimo approccio \u00e8 l’opportunit\u00e0 di vertical scaling descritta nell’ultima sezione. Tuttavia, ce ne sono molti altri in base alle esigenze del vostro sito:<\/p>\n Questo \u00e8 un elemento cruciale del vostro flusso di lavoro di gestione del database, ovvero l’utilizzo delle informazioni che richiedete. Analizziamo questo aspetto nella penultima sezione.<\/p>\n Molti progetti sono costituiti da pi\u00f9 fasi, come lo sviluppo iniziale, lo staging<\/a>, i test e la produzione. La disponibilit\u00e0 dell’API di Kinsta pu\u00f2 aiutarvi a gestire molte attivit\u00e0 in associazione con altri strumenti. La creazione e la gestione dei database pu\u00f2 essere un ingranaggio fondamentale.<\/p>\n Ad esempio, quando create un nuovo branch di funzionalit\u00e0 all’interno del sistema di controllo della versione (VCS) che avete scelto, potete attivare un processo di creazione di un nuovo database utilizzando l’API di Kinsta.<\/p>\n Ecco un esempio semplificato di come attivare la creazione di un database utilizzando l’API:<\/p>\n Ecco un esempio tipico e multiuso in cui definiamo una funzione per creare un database che effettua una richiesta Con questo approccio alla creazione automatica dei database, potete assicurarvi che le fasi o le funzioni abbiano un database dedicato. In questo modo sar\u00e0 pi\u00f9 facile gestire il flusso di lavoro dello sviluppo, avrete una base pi\u00f9 pulita su cui lavorare e ridurrete il rischio di conflitti.<\/p>\n Un altro caso d’uso comune e prezioso per la gestione dei database con l’API di Kinsta \u00e8 quello di fornire aggiornamenti sullo stato dei lavori ai vostri strumenti di collaborazione, come Slack o Microsoft Teams<\/a>. Ad esempio, potete gestire un canale separato che pubblichi solo gli stati dei database.<\/p>\n In questo modo potrete tenere il vostro team aggiornato sullo stato e sulla disponibilit\u00e0 dei database. Questo non solo favorisce una migliore comunicazione e collaborazione, ma pu\u00f2 anche aumentare il livello di proattivit\u00e0 nei confronti di errori e problemi.<\/p>\n Questo tipo di integrazione offre molti altri vantaggi:<\/p>\n Collegare l’API di Kinsta con l’endpoint di autenticazione<\/a> di uno strumento sembra complesso sulla carta, ma in pratica non ci vuole molto:<\/p>\n In questo frammento di codice, definiamo una funzione che utilizza un webhook di Slack per inviare messaggi a un canale Slack. Poi, eseguiamo una richiesta a Questi sono solo due modi rapidi per integrare l’API di Kinsta con altre piattaforme per gestire i vostri database. In ogni caso, potrete ottenere risultati migliori per i progetti e una maggiore efficienza sviluppando al contempo un servizio migliore.<\/p>\n La gestione dei database \u00e8 un aspetto talmente importante nella gestione di un progetto o di un’applicazione WordPress che vi abbiamo fornito l’endpoint database<\/strong> all’interno dell’API di Kinsta<\/a>. Potete utilizzarlo per semplificare il processo di gestione del database e automatizzare attivit\u00e0 specifiche per le quali avreste altrimenti bisogno della dashboard MyKinsta<\/a>.<\/p>\n Sebbene i metodi per realizzare queste attivit\u00e0 siano semplici, avete a disposizione un grande controllo. Ad esempio, potete semplicemente aggiungere o eliminare nuovi database. Esistono molti modi “creativi” per utilizzare queste richieste, come lo scaling delle risorse, la manutenzione generale dei database e molto altro ancora.<\/p>\n Ci piacerebbe conoscere le vostre opinioni sulla creazione e la gestione dei database utilizzando le API di Kinsta. Condividete le vostre esperienze e le vostre intuizioni nella sezione commenti qui sotto!<\/em><\/p>\n","protected":false},"excerpt":{"rendered":" Noi di Kinsta aiutiamo a supportare migliaia di siti web di tutte le dimensioni. Una cosa che li accomuna tutti \u00e8 la necessit\u00e0 di un database. …<\/p>\n","protected":false},"author":199,"featured_media":77928,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_kinsta_gated_content":false,"_kinsta_gated_content_redirect":"","footnotes":""},"tags":[],"topic":[26232],"class_list":["post-77927","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","topic-api"],"yoast_head":"\n\n
I vantaggi della gestione dei database tramite l’API di Kinsta<\/h2>\n
1. Ottimizzare i processi di gestione attuali<\/h3>\n
![\"Un](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/05\/database-access.png\")
![\"La](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/05\/databases-page.png\")
2. Le possibilit\u00e0 di automazione a disposizione sono pressoch\u00e9 infinite<\/h3>\n
3. Potenziale integrazione con altri strumenti e piattaforme<\/h3>\n
![\"Un](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/05\/ifttt-slack.png\")
Cosa serve per gestire i database con l’API di Kinsta<\/h2>\n
database<\/code> \u00e8 un processo semplice, come qualsiasi altro endpoint dell’API Kinsta. In questa sede non ci addentreremo in tutte le sottigliezze di ogni azione o flusso di lavoro, anche se pi\u00f9 avanti ne parleremo ancora.<\/p>\ndatabase<\/code> \u00e8 necessario avere a disposizione alcune informazioni, tra cui un token API valido. Generarlo permetter\u00e0 di accedere all’API, cosa che vale per ogni endpoint. Infatti, abbiamo un endpoint di autenticazione<\/a> per questo scopo.<\/p>\n![\"La](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/05\/mykinsta-api-keys.png\")
![\"La](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/05\/company-id-toolbar.png\")
Creare un nuovo database utilizzando l’API di Kinsta<\/h2>\n
POST<\/code> e ci sono otto attributi necessari affinch\u00e9 la richiesta sia valida. Questi includono la posizione del server, il tipo di risorsa, il tipo di database e le credenziali del database.<\/p>\nimport fetch from 'node-fetch';\n\n\nasync function run() {\n const resp = await fetch(\n`https:\/\/api.kinsta.com\/v2\/databases`,\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\n const data = await resp.json();\n console.log(data);\n}\n\nrun();\n<\/code><\/pre>\n{\n \"database\": {\n\"id\": \"54fb80af-576c-4fdc-ba4f-b596c83f15a1\"\n }\n}\n<\/code><\/pre>\n{\n \"message\": \"No or invalid API key provided to the request\",\n \"status\": 401,\n \"data\": null\n}\n<\/code><\/pre>\n\n
database<\/code>. Nella prossima sezione vedremo come eliminarli.<\/p>\nRecuperare e cancellare i database esistenti<\/h2>\n
GET<\/code> richiede semplicemente che specifichiate il metodo all’interno del vostro codice:<\/p>\nimport fetch from 'node-fetch';\n\nasync function run() {\n const query = new URLSearchParams({\n internal: 'true',\n external: 'true'\n }).toString();\n\n const id = 'YOUR_id_PARAMETER';\n const resp = await fetch(\n `https:\/\/api.kinsta.com\/v2\/databases\/${id}?${query}`,\n {\n method: 'GET',\n headers: {\n Authorization: 'Bearer <YOUR_TOKEN_HERE>'\n }\n }\n );\n\n const data = await resp.text();\n console.log(data);\n}\n\nrun();\n<\/code><\/pre>\n{\n \"database\": {\n \"id\": \"54fb80af-576c-4fdc-ba4f-b596c83f15a1\",\n \"name\": \"unique-db-name\",\n \"display_name\": \"firstsite-db\",\n \"status\": \"ready\",\n \"created_at\": 1668697088806,\n \"memory_limit\": 250,\n \"cpu_limit\": 250,\n \"storage_size\": 1000,\n \"type\": \"postgresql\",\n \"version\": \"14\",\n \"cluster\": {\n \"id\": \"54fb80af-576c-4fdc-ba4f-b596c83f15a1\",\n \"location\": \"europe-west3\",\n \"display_name\": \"Frankfurt, Germany Europe\"\n },\n \"resource_type_name\": \"db1\",\n \"internal_hostname\": \"some-name.dns.svc.cluster.local\",\n \"internal_port\": \"5432\",\n \"internal_connections\": [\n {\n \"id\": \"54fb80af-576c-4fdc-ba4f-b596c83f15a1\",\n \"type\": \"appResource\"\n }\n ],\n \"data\": {\n \"db_name\": \"firstsite-db\",\n \"db_password\": \"password\",\n \"db_root_password\": \"password\",\n \"db_user\": \"username\"\n },\n \"external_connection_string\": \"postgresql:\/\/username:password@localhost:31866\/firstsite-db\",\n \"external_hostname\": \"firstsite-db-postgresql.external.kinsta.app\",\n \"external_port\": \"31866\"\n }\n}\n<\/code><\/pre>\nDELETE<\/code> e l’ID all’endpoint database<\/code>:<\/p>\n\u2026\nconst resp = await fetch(\n `https:\/\/api.kinsta.com\/v2\/databases\/${id}`,\n {\n method: 'DELETE',\n headers: {\n\u2026\n<\/code><\/pre>\nCome l’API di Kinsta aiuta ad aggiornare i database<\/h2>\n
{\n \"resource_type\": \"db1\",\n \"display_name\": \"test-db\"\n}\n<\/code><\/pre>\nL’importanza di resource_type nel vertical scaling<\/h3>\n
import fetch from 'node-fetch';\n\nasync function run() {\n const id = 'YOUR_id_PARAMETER';\n const resp = await fetch(\n `https:\/\/api.kinsta.com\/v2\/databases\/${id}`,\n {\n method: 'PUT',\n headers: {\n 'Content-Type': 'application\/json',\n Authorization: 'Bearer <YOUR_TOKEN_HERE>'\n },\n body: JSON.stringify({\n resource_type: 'db1',\n display_name: 'test-db'\n })\n }\n );\n\n const data = await resp.json();\n console.log(data);\n}\n\nrun();\n<\/code><\/pre>\ndb8<\/code> vi dar\u00e0 pi\u00f9 di db1<\/code>.<\/p>\nIntegrazione con altri endpoint API di Kinsta<\/h3>\n
\n
Utilizzare le informazioni sul database dall’API di Kinsta nel proprio flusso di lavoro<\/h2>\n
import fetch from 'node-fetch';\n\nasync function createDatabase(databaseName) {\n const apiToken = 'your_api_token';\n const companyId = 'your_company_id';\n\n const response = await fetch('https:\/\/api.kinsta.com\/v2\/databases', {\n method: 'POST',\n headers: {\n 'Content-Type': 'application\/json',\n 'Authorization': `Bearer ${apiToken}`\n },\n body: JSON.stringify({\n company_id: companyId,\n location: 'us-central1',\n resource_type: 'db1',\n display_name: databaseName,\n db_name: databaseName,\n db_password: 'example-password',\n db_user: 'example-user',\n type: 'postgresql',\n version: '15'\n })\n });\n\n\n if (response.ok) {\n const data = await response.json();\n console.log(`Database '${databaseName}' created successfully.`);\n console.log('Database details:', data);\n } else {\n console.error(`Error creating database '${databaseName}':`, response.statusText);\n }\n}\n\n\n\/\/ Usage example\nconst featureBranchName = 'feature\/new-blog-section';\nconst databaseName = `db_${featureBranchName}`;\ncreateDatabase(databaseName);\n<\/code><\/pre>\nPOST<\/code> all’endpoint database<\/code>. Il nostro esempio di utilizzo mostra il processo: una variabile contiene il percorso del branch della funzione Git<\/a>, che poi utilizziamo come parametro per la funzione databaseName<\/code>. Da qui, possiamo attivare il processo di creazione in base al nome dinamico del database.<\/p>\nIntegrare le informazioni del database negli strumenti di collaborazione<\/h3>\n
\n
import fetch from 'node-fetch';\nconst { IncomingWebhook } = require('@slack\/webhook');\n\n\/\/ Set up the Slack webhook URL (using an environment variable)\nconst slackWebhookUrl = process.env.SLACK_WEBHOOK_URL;\nconst webhook = new IncomingWebhook(slackWebhookUrl);\n\nasync function sendSlackNotification(message) {\n try {\n await webhook.send({\n text: message\n });\n console.log('Slack notification sent successfully.');\n } catch (error) {\n console.error('Error sending Slack notification:', error);\n }\n}\n\nasync function getDatabases() {\n const apiToken = process.env.KINSTA_API_TOKEN;\n const companyId = process.env.KINSTA_COMPANY_ID;\n\n const query = new URLSearchParams({\n company: companyId,\n limit: '10',\n offset: '3'\n }).toString();\n\n try {\n const response = await fetch(`https:\/\/api.kinsta.com\/v2\/databases?${query}`, {\n method: 'GET',\n headers: {\n 'Authorization': `Bearer ${apiToken}`\n }\n });\n\n\nif (response.ok) {\n const data = await response.json();\n console.log('Retrieved databases:', data);\n\n \/\/ Check the status of each database and send Slack notifications if necessary\n data.forEach(database => {\n if (database.status !== 'ready') {\n const message = `Database '${database.display_name}' is in status '${database.status}'. Please check.`;\n sendSlackNotification(message);\n }\n });\n} else {\n console.error('Error retrieving databases:', response.statusText);\n}\n } catch (error) {\n console.error('Error retrieving databases:', error);\n }\n}\n\n\/\/ Usage example\n\ngetDatabases();\n<\/code><\/pre>\nGET<\/code> per recuperare un elenco di database associati al nostro server. Per i database che non hanno uno stato “pronto”, inviamo una notifica al canale Slack.<\/p>\nRiepilogo<\/h2>\n