El Secreto para la Incorporación de Gráficos

Rate this content
Bookmark

"¿Para qué se utiliza GraphQL?" "¿Cómo encuentro los campos que necesito?" "¿Cómo pruebo las consultas en un gráfico local?" Todas estas son preguntas comunes y válidas que tienen los desarrolladores que están aprendiendo GraphQL cuando comienzan a trabajar con un gráfico unificado. ¿El secreto para superar estos desafíos? ¡Lo adivinaste, Apollo Studio! En esta sesión, profundizaremos en las mejores herramientas de Apollo Studio para ayudar a los desarrolladores nuevos (y experimentados) a sentirse seguros al realizar consultas y colaborar en un gráfico unificado.

This talk has been presented at GraphQL Galaxy 2021, check out the latest edition of this Tech Conference.

FAQ

Un gráfico en GraphQL se refiere a la estructura de datos utilizada para describir la relación entre diferentes tipos de datos en una API, facilitando la ejecución de consultas eficientes y la obtención de información específica de manera detallada.

Hacer un gráfico más utilizable es crucial para facilitar la incorporación de nuevos usuarios y equipos al proyecto, además de escalar la velocidad de desarrollo del gráfico más allá de un solo individuo o equipo, optimizando así el proceso de desarrollo y colaboración.

Las empresas suelen utilizar canales de Slack con hashtags de GraphQL, organizar sesiones de incorporación regulares, sesiones de almuerzo y aprendizaje, charlas informales y crear secciones de gráficos en wikis internos o sitios web completos para facilitar la incorporación de nuevas personas a su gráfico.

Las empresas establecen herramientas como la observabilidad de APIs para recibir alertas sobre el uso de campos de esquema, y configuraciones de linting de esquema y consultas para asegurar que las directivas apropiadas estén presentes y se sigan las convenciones de nomenclatura.

Configurar un portal para desarrolladores en GraphQL implica crear una página web personalizada que incluya funcionalidades como autenticación fácil y una integración del IDE de consultas, mejorando así la accesibilidad y usabilidad del gráfico para los desarrolladores.

Las estrategias para manejar la autenticación en un gráfico GraphQL incluyen el uso de mutaciones para obtener tokens de acceso y la integración de controles de autenticación directamente en el sitio del portal de desarrolladores, permitiendo a los usuarios autenticarse de manera sencilla y segura.

Para hacer un gráfico GraphQL accesible, es efectivo crear un gráfico público en plataformas como Apollo Studio, personalizar su página de inicio con metadatos relevantes y enlaces externos, y proporcionar un enlace directo a un portal de desarrolladores con funciones de inicio de sesión integradas.

Danielle Man
Danielle Man
24 min
10 Dec, 2021

Comments

Sign in or register to post your comment.
Video Summary and Transcription
La charla de hoy se centró en hacer que los gráficos de GraphQL sean más utilizables y accesibles. Se trataron temas como la incorporación de desarrolladores, la aplicación del uso del gráfico, el manejo de errores y autenticación, la creación de un portal personalizado para desarrolladores, la mejora del botón de inicio de sesión y la experiencia del IDE de consultas, la aplicación de reglas y la construcción y personalización de gráficos públicos.
Available in English: The Secret to Graph Onboarding

1. Introducción a hacer que tu gráfico sea más utilizable

Short description:

¡Hola a todos! Hoy quiero compartir consejos para configurar tu gráfico para que sea más utilizable para otras personas. La introspección de GraphQL y las herramientas generadas automáticamente lo hacen autoexplicativo, pero a medida que tu gráfico crece, necesitarás escalar el desarrollo e incorporar nuevos usuarios. Pensar en la usabilidad del gráfico desde el principio facilita la incorporación.

¡Hola a todos! Mi nombre es Danielle y soy directora de ingeniería en Apollo, donde he estado trabajando en ayudar a las personas a utilizar gráficos durante más de cinco años. Y hoy quiero compartir algunos consejos contigo sobre cómo configurar tu gráfico para que otras personas puedan usarlo con éxito.

Esta charla será un poco diferente a una inmersión profunda en GraphQL estándar porque en lugar de hablar sobre algunos de los elementos que intervienen en la construcción de un gráfico, me gustaría hablar sobre cómo las personas utilizan los gráficos. Y en particular, me gustaría hablar sobre cómo hacer que tu gráfico sea más utilizable para otras personas.

Tal vez te preguntes, ¿por qué es importante tomar medidas explícitas para hacer que tu gráfico sea más utilizable? Bueno, GraphQL tiene la introspección incorporada en su especificación, por lo que es autoexplicativo, ¿verdad? Y el ecosistema de GraphQL tiene muchas herramientas maravillosas que se generan automáticamente a partir de la introspección de GraphQL para crear cosas como diagramas de esquema y sitios de documentación rápidos. Pero la realidad es que, al igual que cualquier otro código que escribas o cualquier otro producto que tenga un poco de éxito, eventualmente crecerá y crecerá. Y necesitarás escalar la velocidad de desarrollo de tus gráficos más allá de una sola persona o un solo equipo de personas. Y cuanto más pienses en cómo quieres usar tu gráfico desde el principio, más fácil será incorporar a nuevas personas a tu gráfico en el futuro.

2. Onboarding Developers and Enforcing Graph Usage

Short description:

Hoy discutiremos cómo incorporar a los desarrolladores en gráficos a gran escala y crear una experiencia similar a un portal para desarrolladores para una integración fácil. También exploraremos herramientas para hacer cumplir el uso del gráfico y establecer convenciones de nomenclatura. Además, cubriremos herramientas de linting de esquema y consultas para gráficos federados y los beneficios de capturar metadatos mediante directivas de GraphQL.

Así que hoy, hablaré primero sobre cómo las personas que están ejecutando gráficos a gran escala están incorporando a los desarrolladores en sus gráficos tanto para consumir como para contribuir. Y luego, la mayor parte de nuestro tiempo, escribiré código junto con ustedes y les mostraré cómo pueden configurar su gráfico con una experiencia similar a un portal para desarrolladores para que otras personas puedan conectarse con muy poco esfuerzo. Así que vamos a sumergirnos.

Siento que la comunidad de GraphQL está inundada de contenido técnico relacionado con cómo escalar un gráfico. Pero no he visto mucho contenido sobre el lado humano de escalar un gráfico. Así que pregunté a algunos de nuestros clientes y a algunas personas de nuestra comunidad, ¿qué hacen para incorporar a nuevas personas a su gráfico? Y recibí muchas respuestas con superposición. Así que fue emocionante ver muchos de los patrones y lo que la gente estaba haciendo.

Muchas personas están utilizando canales internos de Slack con el hashtag GraphQL para estar disponibles para preguntas y crear procesos en torno a cosas como el diseño de esquemas. Muchas personas organizan sesiones regulares de incorporación para ayudar a los nuevos equipos a comenzar. Las personas también organizan sesiones mensuales de almuerzo y aprendizaje y charlas informales sobre temas avanzados de GraphQL o para hablar sobre cosas nuevas que están sucediendo en el ecosistema. Y muchas personas han creado una sección de gráficos en sus wikis internos. Algunas personas incluso han creado sitios web completos de gráficos. Y estos sitios les indican a las personas cómo comenzar con un gráfico, cómo autenticarse con las necesidades únicas de cada empresa, qué tipos de convenciones sigue este gráfico, etc.

Algunas de mis respuestas favoritas que recibí fueron en realidad sobre las herramientas que las personas han configurado para hacer cumplir que su gráfico se utilice de acuerdo con las reglas de la empresa. Un ejemplo es que hay muchas formas en que las personas configuran la observabilidad para sus APIs. Y con GraphQL, una vez que agregas algo a un gráfico, se vuelve descubrible a través de la introspección. Por lo tanto, es muy posible que agregues un campo a tu esquema para tu propio uso, pero alguien más en otro departamento también podría comenzar a usarlo. Entonces, si requieres que cada solicitud que se realice a tu gráfico tenga encabezados para identificar qué cliente está realizando esas solicitudes, entonces puedes configurar la observabilidad para recibir alertas cada vez que un nuevo cliente comienza a usar tu campo, lo cual se convierte en información realmente útil a medida que evolucionas un gráfico. Y lo que tengo en esta diapositiva es solo un ejemplo de cómo se ve la observabilidad a nivel de cliente en Apollo Studio.

Otro patrón que me gustó mucho fue la idea de establecer algunas convenciones de nomenclatura para tus operaciones. Entonces, en primer lugar, una cosa que puedes hacer es asegurarte de que cada operación en tu servidor tenga un nombre, pero además de eso, puedes establecer convenciones de nomenclatura para que todas tus operaciones tengan un nombre estandarizado. Y esto se vuelve realmente útil a largo plazo porque inevitablemente, un día, tendrás algún problema con alguna sección de tu gráfico, y si todas tus operaciones siguen una convención de nomenclatura estándar, será muy fácil determinar qué partes de tus productos se ven afectadas por este problema del gráfico. Entonces, aunque los nombres de las operaciones no son identificadores únicos, en la práctica son realmente útiles como herramienta para la resiliencia del producto.

Y luego, en cuanto a las herramientas para desarrolladores, hubo un patrón de personas que configuraban herramientas de linting de esquema y consultas que me gustó mucho. Un ejemplo de esto es en un gráfico federado donde tienes muchos subgráficos que son propiedad y están controlados de forma independiente por diferentes equipos, a menudo puede ser realmente útil hacer cumplir que cada esquema de subgráfico tenga información de contacto en el propio esquema. Y puedes usar directivas de GraphQL para definir información de contacto. Y luego puedes usar herramientas de linting de esquema y GraphQL para asegurarte de que esas directivas estén presentes. Y una de las cosas interesantes de usar el esquema y las directivas y el linting para capturar todos esos metadatos es que todas las herramientas más adelante en el ecosistema de GraphQL pueden hacer uso de esos metadatos también. Aquí en la captura de pantalla tengo una imagen de la página de documentación como la documentación de esquema para un gráfico en Studio que muestra información de contacto sobre el subgráfico al que pertenece un campo en particular. Y hay muchas más convenciones que podrías establecer en esta misma línea.

Check out more articles and videos

We constantly think of articles and videos that might spark Git people interest / skill us up or help building a stellar career

De GraphQL Zero a GraphQL Hero con RedwoodJS
GraphQL Galaxy 2021GraphQL Galaxy 2021
32 min
De GraphQL Zero a GraphQL Hero con RedwoodJS
Top Content
Tom Pressenwurter introduces Redwood.js, a full stack app framework for building GraphQL APIs easily and maintainably. He demonstrates a Redwood.js application with a React-based front end and a Node.js API. Redwood.js offers a simplified folder structure and schema for organizing the application. It provides easy data manipulation and CRUD operations through GraphQL functions. Redwood.js allows for easy implementation of new queries and directives, including authentication and limiting access to data. It is a stable and production-ready framework that integrates well with other front-end technologies.
Estado Local y Caché del Servidor: Encontrando un Equilibrio
Vue.js London Live 2021Vue.js London Live 2021
24 min
Estado Local y Caché del Servidor: Encontrando un Equilibrio
Top Content
This Talk discusses handling local state in software development, particularly when dealing with asynchronous behavior and API requests. It explores the challenges of managing global state and the need for actions when handling server data. The Talk also highlights the issue of fetching data not in Vuex and the challenges of keeping data up-to-date in Vuex. It mentions alternative tools like Apollo Client and React Query for handling local state. The Talk concludes with a discussion on GitLab going public and the celebration that followed.
Baterías Incluidas Reimaginadas - El Resurgimiento de GraphQL Yoga
GraphQL Galaxy 2021GraphQL Galaxy 2021
33 min
Baterías Incluidas Reimaginadas - El Resurgimiento de GraphQL Yoga
Envelope is a powerful GraphQL plugin system that simplifies server development and allows for powerful plugin integration. It provides conformity for large corporations with multiple GraphQL servers and can be used with various frameworks. Envelope acts as the Babel of GraphQL, allowing the use of non-spec features. The Guild offers GraphQL Hive, a service similar to Apollo Studio, and encourages collaboration with other frameworks and languages.
Aplicaciones sólidas de React y GraphQL para personas con prisa
GraphQL Galaxy 2022GraphQL Galaxy 2022
29 min
Aplicaciones sólidas de React y GraphQL para personas con prisa
The Talk discusses the challenges and advancements in using GraphQL and React together. It introduces RedwoodJS, a framework that simplifies frontend-backend integration and provides features like code generation, scaffolding, and authentication. The Talk demonstrates how to set up a Redwood project, generate layouts and models, and perform CRUD operations. Redwood automates many GraphQL parts and provides an easy way for developers to get started with GraphQL. It also highlights the benefits of Redwood and suggests checking out RedwoodJS.com for more information.
Adoptando GraphQL en una Empresa
GraphQL Galaxy 2021GraphQL Galaxy 2021
32 min
Adoptando GraphQL en una Empresa
Today's Talk is about adopting GraphQL in an enterprise. It discusses the challenges of using REST APIs and the benefits of GraphQL. The Talk explores different approaches to adopting GraphQL, including coexistence with REST APIs. It emphasizes the power of GraphQL and provides tips for successful adoption. Overall, the Talk highlights the advantages of GraphQL in terms of efficiency, collaboration, and control over APIs.
Deja paso a los resolvers: un nuevo enfoque para la ejecución de GraphQL
GraphQL Galaxy 2022GraphQL Galaxy 2022
16 min
Deja paso a los resolvers: un nuevo enfoque para la ejecución de GraphQL
GraphQL has made a huge impact in the way we build client applications, websites, and mobile apps. Despite the dominance of resolvers, the GraphQL specification does not mandate their use. Introducing Graphast, a new project that compiles GraphQL operations into execution and output plans, providing advanced optimizations. In GraphFast, instead of resolvers, we have plan resolvers that deal with future data. Graphfast plan resolvers are short and efficient, supporting all features of modern GraphQL.

Workshops on related topic

Construir con SvelteKit y GraphQL
GraphQL Galaxy 2021GraphQL Galaxy 2021
140 min
Construir con SvelteKit y GraphQL
Top Content
Featured WorkshopFree
Scott Spence
Scott Spence
¿Alguna vez has pensado en construir algo que no requiera mucho código de plantilla con un tamaño de paquete pequeño? En esta masterclass, Scott Spence irá desde el hola mundo hasta cubrir el enrutamiento y el uso de endpoints en SvelteKit. Configurarás una API de GraphQL en el backend y luego usarás consultas de GraphQL con SvelteKit para mostrar los datos de la API de GraphQL. Construirás un proyecto rápido y seguro que utiliza las características de SvelteKit, y luego lo desplegarás como un sitio completamente estático. Este curso es para los curiosos de Svelte que no han tenido una experiencia extensa con SvelteKit y quieren una comprensión más profunda de cómo usarlo en aplicaciones prácticas.

Tabla de contenidos:
- Inicio e introducción a Svelte
- Inicializar el proyecto frontend
- Recorrido por el proyecto esqueleto de SvelteKit
- Configurar el proyecto backend
- Consultar datos con GraphQL
- Recuperación de datos en el frontend con GraphQL
- Estilización
- Directivas de Svelte
- Enrutamiento en SvelteKit
- Endpoints en SvelteKit
- Despliegue en Netlify
- Navegación
- Mutaciones en GraphCMS
- Envío de mutaciones GraphQL a través de SvelteKit
- Preguntas y respuestas
Construye Aplicaciones Modernas Utilizando GraphQL y Javascript
Node Congress 2024Node Congress 2024
152 min
Construye Aplicaciones Modernas Utilizando GraphQL y Javascript
Featured Workshop
Emanuel Scirlet
Miguel Henriques
2 authors
Ven y aprende cómo puedes potenciar tus aplicaciones modernas y seguras utilizando GraphQL y Javascript. En este masterclass construiremos una API de GraphQL y demostraremos los beneficios del lenguaje de consulta para APIs y los casos de uso para los que es adecuado. Se requiere conocimiento básico de Javascript.
Seguridad de tipo de extremo a extremo con React, GraphQL y Prisma
React Advanced 2022React Advanced 2022
95 min
Seguridad de tipo de extremo a extremo con React, GraphQL y Prisma
Featured WorkshopFree
Sabin Adams
Sabin Adams
En este masterclass, obtendrás una visión de primera mano de lo que es la seguridad de tipo de extremo a extremo y por qué es importante. Para lograr esto, construirás una API de GraphQL utilizando herramientas modernas y relevantes que serán consumidas por un cliente de React.
Prerrequisitos: - Node.js instalado en tu máquina (12.2.X / 14.X)- Se recomienda (pero no es obligatorio) utilizar VS Code para las tareas prácticas- Un IDE instalado (se recomienda VSCode)- (Bueno tener) *Un conocimiento básico de Node.js, React y TypeScript
GraphQL para Desarrolladores de React
GraphQL Galaxy 2022GraphQL Galaxy 2022
112 min
GraphQL para Desarrolladores de React
Featured Workshop
Roy Derks
Roy Derks
Hay muchas ventajas en utilizar GraphQL como fuente de datos para el desarrollo frontend, en comparación con las API REST. Nosotros, los desarrolladores, por ejemplo, necesitamos escribir mucho código imperativo para recuperar datos y mostrarlos en nuestras aplicaciones y manejar el estado. Con GraphQL, no solo puedes reducir la cantidad de código necesario para la obtención de datos y la gestión del estado, sino que también obtendrás una mayor flexibilidad, mejor rendimiento y, sobre todo, una mejor experiencia de desarrollo. En este masterclass aprenderás cómo GraphQL puede mejorar tu trabajo como desarrollador frontend y cómo manejar GraphQL en tu aplicación frontend de React.
Construye una aplicación WordPress sin cabeza con Next.js y WPGraphQL
React Summit 2022React Summit 2022
173 min
Construye una aplicación WordPress sin cabeza con Next.js y WPGraphQL
Top Content
WorkshopFree
Kellen Mace
Kellen Mace
En esta masterclass, aprenderás cómo construir una aplicación Next.js que utiliza Apollo Client para obtener datos de un backend de WordPress sin cabeza y usarlo para renderizar las páginas de tu aplicación. Aprenderás cuándo debes considerar una arquitectura de WordPress sin cabeza, cómo convertir un backend de WordPress en un servidor GraphQL, cómo componer consultas usando el IDE GraphiQL, cómo colocar fragmentos GraphQL con tus componentes, y más.
Modelado de Bases de Datos Relacionales para GraphQL
GraphQL Galaxy 2020GraphQL Galaxy 2020
106 min
Modelado de Bases de Datos Relacionales para GraphQL
Top Content
WorkshopFree
Adron Hall
Adron Hall
En esta masterclass profundizaremos en el modelado de datos. Comenzaremos con una discusión sobre varios tipos de bases de datos y cómo se mapean a GraphQL. Una vez que se haya establecido esa base, el enfoque se desplazará a tipos específicos de bases de datos y cómo construir modelos de datos que funcionen mejor para GraphQL en varios escenarios.
Índice de contenidosParte 1 - Hora 1      a. Modelado de Datos de Bases de Datos Relacionales      b. Comparando Bases de Datos Relacionales y NoSQL      c. GraphQL con la Base de Datos en menteParte 2 - Hora 2      a. Diseño de Modelos de Datos Relacionales      b. Relación, Construcción de Tablas Multijoin      c. Complejidades de Consulta de Modelado de Datos Relacionales y GraphQL
Prerrequisitos      a. Herramienta de modelado de datos. El formador utilizará dbdiagram      b. Postgres, aunque no es necesario instalar esto localmente, ya que estaré utilizando una imagen de Dicker de Postgres, de Docker Hub para todos los ejemplos      c. Hasura