Surge.sh es un servidor de sitios web estático gratuito con el que interactúa desde su línea de comandos. Hace que sea rápido y fácil obtener nuevos sitios y aplicaciones en línea, ya sea manualmente o como parte de su proceso de creación de CI. A continuación se explica cómo empezar a utilizar el servicio.
Primer intento
Asumiremos que ya tiene un directorio de archivos que desea implementar en la web. Si no lo ha hecho, cree una nueva carpeta, agregue una
index.html
y contenido inicial sencillo.
El binario de Surge es una aplicación JavaScript distribuida a través de npm. Asegúrate de haber obtuve Node.js instalado en su sistema antes de continuar. Comience usando npm para instalar Surge:
npm install
Instalar Surge globalmente significa que puede usar el comando surge en cualquier lugar, incluso si su directorio de trabajo carece de un archivo package.json. Omitir el indicador –global agregará el paquete como una dependencia del proyecto, lo que le permitirá bloquear la versión de Surge utilizada para sitios individuales.
Ahora cambie el directorio al repositorio de su sitio web. Ejecute el comando surge para iniciar el proceso de implementación. Se mostrará una serie de indicaciones interactivas, comenzando con su dirección de correo electrónico para configurar una cuenta Surge.
A continuación, confirme la ruta del sistema de archivos a su proyecto. El valor predeterminado es su directorio de trabajo, por lo que normalmente puede presionar Intro para continuar.
El siguiente mensaje solicita un nombre de dominio. Se selecciona automáticamente un subdominio aleatorio .surge.sh. Puedes elegir un subdominio diferente, o uno de tus propios dominios, ingresándolo aquí. Si está utilizando su propio dominio, las siguientes secciones explican cómo terminar de configurarlo.
Después de haber proporcionado un nombre de dominio, presione Intro para comenzar la implementación. El progreso se mostrará en su terminal a medida que Surge CLI cargue sus archivos y los ponga a disposición en la web. ¡Visite su dominio en su navegador para ver su contenido en vivo!
Las actualizaciones del sitio se aplican ejecutando nuevamente el comando surge. El contenido del directorio de su proyecto se sincronizará con su sitio web en vivo.
Todo lo que hay en su carpeta se carga de forma predeterminada. Puede excluir rutas específicas creando un archivo .surgeignore. Tiene la misma sintaxis que .gitignore. Archivos y carpetas creado comúnmente por otras herramientas de desarrollo, como Git y npm, se omiten automáticamente.
Usando su propio nombre de dominio
Ofertas de aumento soporte de dominio personalizado a través de registros CNAME. Esto no tiene ningún coste adicional respecto al servicio estándar. Agregue un registro CNAME en el panel de control de su proveedor de dominio. Apunte los nombres de host @ y www a na-west1.surge.sh. Proporcione su nombre de dominio cuando ejecute surge para implementar su sitio.
Se le solicitará su dominio cada vez que ejecute el comando de aumento. Puede evitar esto agregando el indicador –domain a los comandos de aumento. Alternativamente, cree un archivo CNAME en el directorio de su proyecto. Escriba su nombre de dominio en este archivo.
surge --domain example.comecho "example.com" > CNAME
Administrar redirecciones HTTPS
Surge tiene soporte HTTPS automático, pero no maneja redireccionamientos HTTP a HTTPS de forma predeterminada. Implemente explícitamente en la variante https de su dominio para obligar a todos los visitantes a utilizar una conexión segura. Es recomendable habilitar redireccionamientos para todos los sitios web de acceso público.
surge --domain https:
Deberá proporcionar un certificado SSL si utiliza su propio dominio. Esta función solo está disponible como parte del pago Sobretensión Plus plan.
Surge también le brinda control de las redirecciones de dominio simple a www. El comportamiento predeterminado es que www.example.com redirija a ejemplo.com. Puede revertir esto incluyendo explícitamente la parte www en su dominio de implementación.
surge --domain https:
Configurando su sitio
Surge ofrece varias funciones de conveniencia integradas que lo ayudan a destacarse frente a otras plataformas similares. Puedes agregar un 404 página, protección de contraseñay Soporte CORStodos usando archivos especiales en su proyecto.
La página 404 se habilita creando un archivo 404.html. Eso es todo: Surge entregará el archivo cuando no haya una coincidencia directa para el URI solicitado.
La protección con contraseña está habilitada mediante un archivo AUTH. Esto acepta una lista simple de nombres de usuario y contraseñas.
cloudsavvy:howtogeek
Se le pedirá que ingrese un nombre de usuario y contraseña usando la autenticación básica HTTP cada vez que acceda a su sitio. Esta función solo está disponible en el plan pago Surge Plus.
Otra característica de Surge Plus son las reglas de enrutamiento manuales. Puede crear un archivo ROUTER para definir redireccionamientos personalizados, ya sea dentro de su sitio o externamente.
301 /moved-page /new-link
Surge admite códigos de estado 301 (movido permanentemente) y 307 (movido temporalmente) para la primera columna. La última columna puede ser un enlace relativo dentro de su sitio o un enlace absoluto a otro dominio (https://www.google.com).
Un archivo de configuración final es CORS. Esto le permite permitir el acceso entre orígenes a su sitio. Agregue un * al archivo para aceptar solicitudes entre orígenes de cualquier origen. En su lugar, puede escribir dominios individuales para limitar los orígenes permitidos.
Automatización de implementaciones repentinas
Surge está completamente controlado por archivos de texto y comandos de terminal. Es fácil de integrar en canalizaciones de CI para implementar sitios web automáticamente en cada confirmación.
La automatización de Surge requiere el uso de tokens API. Esto le permite evitar las solicitudes de inicio de sesión interactivas. Primero, inicie sesión en Surge en su máquina de desarrollo. Ejecute el token de aumento para obtener su token API.
En su canal de CI, configure las variables de entorno SURGE_LOGIN y SURGE_TOKEN. La primera debe ser su dirección de correo electrónico, mientras que la segunda debe recibir su token API. Ahora puede implementar de forma no interactiva utilizando los indicadores –project y –domain:
surge --project $PWD --domain example.com
Resumen
Surge simplifica la publicación de sitios web estáticos en la web. El servicio básico es de uso gratuito. Actualizar al plan Plus le brinda autenticación, redireccionamientos y HTTPS más configurable.
A diferencia de otros contendientes, Surge está totalmente impulsado por terminales. Esto lo hace ideal para sitios rápidos centrados en desarrolladores administrados a través de repositorios Git y canalizaciones de CI. Elimina la configuración del servidor para que pueda concentrarse en crear el contenido de su sitio.
Para casos de uso más avanzados, Surge incluso le permite agregar varios contribuyentes. Ejecute surge –add [email protected] para dar acceso a su sitio a amigos, invitados y colegas. Podrán implementar ejecutando surge y proporcionando el mismo nombre de dominio que has estado usando.
