Un bref aper\u00e7u de l’API Kinsta<\/h2>\n
En bref, l’API Kinsta<\/a> vous permet d’interagir de mani\u00e8re programmatique avec vos sites et environnements sur notre plateforme. Nous vous fournissons un ensemble de points de terminaison que vous pouvez utiliser pour effectuer diverses t\u00e2ches, telles que la cr\u00e9ation de nouveaux sites WordPress, le clonage de sites existants, la gestion des sauvegardes, et plus encore.<\/p>\n Cette API RESTful<\/a> offre de nombreux avantages \u00e0 vos projets de d\u00e9veloppement gr\u00e2ce \u00e0 ses caract\u00e9ristiques et fonctionnalit\u00e9s cl\u00e9s :<\/p>\n si vous souhaitez en savoir plus sur les possibilit\u00e9s offertes par l’API Kinsta, consultez la documentation d\u00e9di\u00e9e<\/a>. N\u00e9anmoins, nous examinerons de nombreux exemples dans le reste de cet article, apr\u00e8s avoir approfondi les avantages que l’API peut vous apporter.<\/p>\n Bien s\u00fbr, nous adorons le tableau de bord MyKinsta<\/a> pour sa profondeur, son interface magnifique et son niveau de contr\u00f4le. Cependant, vous pouvez \u00e9galement trouver la plupart des fonctionnalit\u00e9s dans l’API Kinsta. Si vous \u00eates un d\u00e9veloppeur, cela devrait vous int\u00e9resser pour plusieurs raisons :<\/p>\n Mais tr\u00eave de bavardage : passons \u00e0 l’utilisation de l’API Kinsta. Nous commencerons par les points de terminaison qui fonctionnent bien pour le d\u00e9veloppement, puis nous les utiliserons dans votre flux de travail.<\/p>\n L’API de Kinsta offre de nombreux points de terminaison, mais certains vous int\u00e9resseront plus que d’autres. Pour le d\u00e9veloppement, vous reviendrez souvent sur certains d’entre eux :<\/p>\n Ces points de terminaison couvrent les fonctionnalit\u00e9s de base dont vous aurez besoin pour la plupart des flux de d\u00e9veloppement. Cependant, d’autres peuvent compl\u00e9ter les points de terminaison que vous utilisez souvent. Par exemple, ceux qui g\u00e8rent les bases de donn\u00e9es, le d\u00e9ploiement, la mise en cache et votre r\u00e9seau de diffusion de contenu (CDN) ont tous un r\u00f4le \u00e0 jouer.<\/p>\n Dans la suite de l’article, nous verrons comment vous pouvez utiliser l’API Kinsta dans le cadre d’un d\u00e9veloppement r\u00e9el. Dans la section des commentaires \u00e0 la fin de l’article, vous pouvez m\u00eame partager vos propres exemples o\u00f9 vous pensez que l’API Kinsta pourrait \u00eatre utile – nous serions ravis de les entendre !<\/p>\n Essayons d’illustrer comment vous pouvez utiliser l’API Kinsta dans la pratique. Il existe de nombreuses fa\u00e7ons de d\u00e9velopper WordPress, nous allons donc voir comment une agence de conception web peut utiliser l’API tout au long d’un flux de travail. En g\u00e9n\u00e9ral, cela implique quelques \u00e9tapes :<\/p>\n Malgr\u00e9 l’importance de l’API Kinsta dans cet article, notre premi\u00e8re \u00e9tape n’en aura pas besoin. Commen\u00e7ons par mettre en place votre environnement de d\u00e9veloppement local, puis passons aux \u00e9l\u00e9ments programmatiques pour la mise \u00e0 l’essai et la production.<\/p>\n Votre environnement local doit \u00eatre solide comme un roc, et chaque d\u00e9veloppeur aura sa propre approche pr\u00e9f\u00e9r\u00e9e<\/a>. Bien s\u00fbr, notre choix ici se portera sur DevKinsta<\/a>.<\/p>\n Cela peut simplifier le processus de mise en place de votre environnement local, en particulier si vous utilisez l’h\u00e9bergement de Kinsta. DevKinsta est gratuit et vous offre de nombreuses fonctionnalit\u00e9s que d’autres outils similaires ne peuvent pas fournir :<\/p>\n DevKinsta fournit \u00e9galement un certain nombre d’outils pour les d\u00e9veloppeurs. Par exemple, vous pouvez activer Xdebug<\/a> en un clic et modifier les fichiers de configuration php.ini<\/strong> et Nginx \u00e0 partir de l’\u00e9cran des r\u00e9glages :<\/p>\n La configuration et l’utilisation de DevKinsta d\u00e9passent le cadre de cet article, car nous voulons nous concentrer sur l’API Kinsta. Cependant, nous disposons d’une documentation compl\u00e8te<\/a> sur le d\u00e9marrage de l’environnement local qui devrait \u00eatre une lecture obligatoire.<\/p>\n \u00c0 ce stade, vous disposez d’un environnement de d\u00e9veloppement local (avec un peu de chance, DevKinsta !) et d’un site suffisamment complet pour passer \u00e0 l’\u00e9tape suivante. La cr\u00e9ation d’un environnement d’essai utilise \u00e0 la fois les fonctionnalit\u00e9s de DevKinsta et celles de l’API Kinsta. D\u00e9composons cela en quelques \u00e9tapes.<\/p>\n Tout d’abord, cr\u00e9ez un nouvel environnement de staging<\/a> avec l’API Kinsta. Vous pouvez le faire \u00e0 l’int\u00e9rieur de DevKinsta gr\u00e2ce \u00e0 des liens vers le tableau de bord MyKinsta :<\/p>\n Cependant, l’API de Kinsta a des points de terminaison<\/a> pour couvrir tous les cas d’utilisation pratiques. Par exemple, vous pouvez cr\u00e9er des sites et des environnements simples et peupl\u00e9s. Nous vous recommandons d’utiliser des environnements simples \u00e0 ce stade, car vous pouvez avoir l’esprit tranquille en sachant que votre site local sera d\u00e9plac\u00e9 vers un emplacement \u00ab frais \u00bb.<\/p>\n Pour ce faire, vous devrez d’abord cr\u00e9er un nouveau site WordPress<\/a> sur Kinsta en utilisant le point de terminaison appropri\u00e9 :<\/p>\n Une fois le site en place, vous pouvez obtenir une liste de sites<\/a> en indiquant l’identifiant de l’entreprise :<\/p>\n Une fois cette \u00e9tape franchie, vous pouvez cr\u00e9er l’environnement de staging<\/a> en utilisant le bon identifiant de site :<\/p>\n Nous vous recommandons \u00e9galement de cr\u00e9er une base de donn\u00e9es pour le site de staging pendant que vous \u00eates ici. Dans quelques instants, vous l’\u00e9craserez avec votre base de donn\u00e9es locale, mais l’initialisation d’un espace r\u00e9serv\u00e9 est une bonne pratique :<\/p>\n En fonction de votre configuration, vous devrez peut-\u00eatre ajouter un nouveau domaine<\/a> \u00e0 Kinsta, ce que vous pouvez faire par le biais d’un simple point de terminaison. Cependant, une fois que le staging est mis en place, vous pouvez chercher \u00e0 pousser vos changements locaux vers ce staging.<\/p>\n Le processus exact pour pousser vos changements vers le staging d\u00e9pendra de votre configuration et de vos outils sp\u00e9cifiques. Une approche g\u00e9n\u00e9rale et typique peut ressembler \u00e0 ce qui suit :<\/p>\n Nous ne couvrirons pas le contr\u00f4le de version<\/a> ici, mais DevKinsta offre des outils pratiques pour vous aider \u00e0 pousser les changements vers votre h\u00e9bergement Kinsta :<\/p>\n Cela vous permettra de choisir l’environnement sur l’ensemble de votre serveur d’h\u00e9bergement. Une fois que vous avez fait cela, vous pouvez \u00e9galement choisir de pousser votre base de donn\u00e9es – encore une fois, quelque chose que peu d’outils de d\u00e9veloppement local vous permettent de faire :<\/p>\n Une fois que vous avez rempli votre environnement Kinsta, l’API vous sera d’une grande utilit\u00e9. Par exemple, vous pouvez cr\u00e9er un script et ex\u00e9cuter une sauvegarde initiale, qui ne n\u00e9cessite qu’un identifiant et un libell\u00e9 d’environnement :<\/p>\n Vous pouvez \u00e9galement installer d’autres th\u00e8mes et extensions<\/a> \u00e0 ce stade si vous le souhaitez. A ce stade, notre utilisation de DevKinsta se termine car vous pouvez d\u00e9ployer votre site en utilisant l’API Kinsta \u00e0 partir de maintenant.<\/p>\n Avant d’envisager de transf\u00e9rer les modifications vers la production<\/a>, vous devrez effectuer quelques t\u00e2ches cruciales, toutes avec l’API Kinsta :<\/p>\n \u00c0 partir de l\u00e0, vous devez tester enti\u00e8rement votre site<\/a> dans l’environnement de staging et obtenir l’approbation de votre client. \u00c0 ce stade, vous pouvez envisager le d\u00e9ploiement. Kinsta vous propose plusieurs options pour cela :<\/p>\n Nous allons (bien s\u00fbr) nous concentrer sur la deuxi\u00e8me option, car elle permet un flux de travail plus automatis\u00e9 et rationalis\u00e9.<\/p>\n L’API Kinsta propose plusieurs fa\u00e7ons de d\u00e9placer un environnement. Vous pouvez pousser votre environnement de staging<\/a> vers votre environnement de production ou le cloner<\/a>.<\/p>\n Quoi qu’il en soit, c’est une bonne id\u00e9e de cr\u00e9er une autre sauvegarde de chaque environnement que vous ex\u00e9cutez afin de pouvoir r\u00e9cup\u00e9rer en cas de probl\u00e8me.<\/p>\n L’API Kinsta est un moyen puissant d’effectuer des changements programmatiques sur vos sites et environnements. En tant que tel, vous devez \u00eatre prudent lorsque vous l’utilisez, car si quelque chose ne va pas, il sera de votre responsabilit\u00e9 de le r\u00e9parer.<\/p>\n Dans cette optique, nous allons passer en revue quelques conseils, astuces et pratiques typiques que vous devriez int\u00e9grer dans votre propre flux de d\u00e9veloppement :<\/p>\n Ceci est beaucoup plus important lorsqu’il s’agit de poursuivre la collaboration avec les \u00e9quipes et l’automatisation que vous pourriez vouloir employer. Notre derni\u00e8re section aborde ce sujet de mani\u00e8re un peu plus d\u00e9taill\u00e9e.<\/p>\n L’un des principaux avantages de l’utilisation de l’API Kinsta est la possibilit\u00e9 d’automatiser les t\u00e2ches r\u00e9p\u00e9titives dans votre flux de d\u00e9veloppement. En \u00e9crivant des scripts ou en int\u00e9grant d’autres outils, vous pouvez rationaliser les processus et gagner du temps.<\/p>\n Pour rationaliser compl\u00e8tement votre flux de travail, vous pouvez automatiser le passage de la phase de pr\u00e9paration \u00e0 la phase de production en int\u00e9grant l’API Kinsta \u00e0 votre pipeline CI\/CD. Il peut s’agir d’un processus complexe et subjectif qui peut m\u00eame changer d’un projet \u00e0 l’autre. Par exemple, voici un exemple de flux de travail pour un script appropri\u00e9 :<\/p>\n C’est le grand avantage de l’API Kinsta. Vous pouvez automatiser presque tous les aspects de votre flux de travail pour garantir des d\u00e9ploiements coh\u00e9rents et fiables. Vous pouvez \u00e9galement faire bien d’autres choses avec cette API :<\/p>\n La beaut\u00e9 de l’API Kinsta r\u00e9side dans la quantit\u00e9 de choses que vous pouvez contr\u00f4ler \u00e0 l’aide de m\u00e9thodes programmatiques. Le champ d’application est large et vous pouvez m\u00eame cr\u00e9er des tableaux de bord personnalis\u00e9s<\/a> qui affichent certaines de ces mesures ou options pour un flux de d\u00e9veloppement encore plus fluide.<\/p>\n\n
Pourquoi vos flux de d\u00e9veloppement peuvent-ils b\u00e9n\u00e9ficier de l’API Kinsta ?<\/h2>\n
![\"Le](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/04\/mykinsta-dashboard-1.png\")
\n
Les points de terminaison de l’API Kinsta pour le d\u00e9veloppement<\/h2>\n
\n
Un cas d’utilisation r\u00e9el : le d\u00e9veloppement d’un site<\/h2>\n
\n
1. Mise en place d’un environnement de d\u00e9veloppement local<\/h3>\n
![\"L'\u00e9cran](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/04\/devkinsta-splash.png\")
\n
![\"Modifier](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/04\/nginx-config.png\")
2. G\u00e9rer les environnements de d\u00e9veloppement local et de staging<\/h3>\n
Cr\u00e9ation d’un environnement de staging<\/h4>\n
![\"Cr\u00e9er](\"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>\nSynchroniser les modifications locales avec celles du staging<\/h4>\n
\n
![\"Les](\"https:\/\/kinsta.com\/wp-content\/uploads\/2024\/04\/push-to-kinsta.png\")
![\"Confirmer](\"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. Transf\u00e9rer les modifications de la phase de staging \u00e0 la phase de production<\/h3>\n
\n
\n
Utiliser l’API pour d\u00e9ployer des changements<\/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>\nPratiques typiques et conseils pour l’utilisation de l’API Kinsta<\/h2>\n
\n
Automatiser votre flux de d\u00e9veloppement<\/h2>\n
\n
\n
R\u00e9sum\u00e9<\/h2>\n