Surge.sh är en gratis statisk webbhotell som du interagerar med från din kommandorad. Det gör det snabbt och enkelt att få nya webbplatser och appar online, antingen manuellt eller som en del av din CI-byggprocess. Så här kommer du igång med att använda tjänsten.
Första körning
Vi antar att du redan har en katalog med filer du vill distribuera till webben. Om du inte har skapat en ny mapp, lagt till en index.html och något enkelt startinnehåll.
Surges binära är en JavaScript-applikation som distribueras via npm. Se till att du har Node.js installerat på ditt system innan du fortsätter. Börja med att använda npm för att installera Surge:
npm install – global surge
Att installera Surge globalt innebär att du kan använda kommandot surge överallt, även om din arbetskatalog saknar en package.json-fil. Om du utelämnar –global-flaggan läggs paketet till som projektberoende istället, så att du låser den Surge-version som används för enskilda webbplatser.
Byt nu katalog till din webbplats förvar. Kör kommandot surge för att starta distributionsprocessen. En serie interaktiva uppmaningar visas, med din e-postadress för att skapa ett Surge-konto.
Annons
Bekräfta sedan filsystemets sökväg till ditt projekt. Detta är som standard din arbetskatalog så att du vanligtvis kan trycka på retur för att fortsätta.
Följande uppmaning ber om ett domännamn. En slumpmässig .surge.sh-underdomän väljs automatiskt. Du kan välja en annan underdomän eller en av dina egna domäner genom att ange den här. Om du använder din egen domän förklarar följande avsnitt hur du klarar konfigureringen.
När du har angett ett domännamn, tryck på Enter för att påbörja distributionen. Framstegen visas i din terminal när Surge CLI laddar upp dina filer och gör dem tillgängliga på webben. Besök din domän i din webbläsare för att se ditt innehåll live!
Webbplatsuppdateringar tillämpas genom att köra kommandot surge igen. Innehållet i din projektkatalog synkroniseras till din livewebbplats.
Allt i din mapp laddas upp som standard. Du kan utesluta specifika sökvägar genom att skapa en .surgeignore-fil. Den här har samma syntax som .gitignore. Filer och mappar som vanligtvis skapas av andra utvecklarverktyg, som Git och npm, utelämnas automatiskt.
Använda ditt eget domännamn
< p> Surge erbjuder anpassat domänsupport via CNAME-poster. Detta kostar ingen extra kostnad jämfört med standardtjänsten. Lägg till en CNAME-post i din domänleverantörs kontrollpanel. Rikta @ och www värdnamn till na-west1.surge.sh. Ange ditt domännamn när du kör surge för att distribuera din webbplats.
Annons
Du kommer att bli ombedd att ange din domän varje gång du kör överspänningskommandot. Du kan undvika detta genom att lägga till –domän-flaggan i överspänningskommandon. Alternativt kan du skapa en CNAME-fil i din projektkatalog. Skriv ditt domännamn i den här filen.
surge –domain example.com echo “example.com” & gt; CNAME
Hantera HTTPS-omdirigeringar
Surge har automatiskt HTTPS-stöd men detta hanterar inte HTTP till HTTPS-omdirigeringar som standard. Distribuera uttryckligen till https-varianten av din domän för att tvinga alla besökare att använda en säker anslutning. Det är tillrådligt att aktivera omdirigeringar för alla offentligt tillgängliga webbplatser.
surge –domän https://example.com
Du måste tillhandahålla ett SSL-certifikat om du använder din egen domän. Den här funktionen är endast tillgänglig som en del av den betalda Surge Plus-planen.
Surge ger dig också kontroll över bare domän till www omdirigeringar. Standardbeteendet ser www.example.com omdirigera till exempel.com. Du kan vända detta genom att uttryckligen inkludera www-delen i din distributionsdomän.
surge –domain https://www.example.com
Konfigurera din webbplats
Surge erbjuder flera inbyggda bekvämlighetsfunktioner som hjälper den att sticka ut mot andra liknande plattformar. Du kan lägga till en 404-sida, lösenordsskydd och CORS-stöd, alla med hjälp av speciella filer i ditt projekt.
404-sidan aktiveras genom att skapa en 404.html-fil. Det är allt som finns i det & # 8211; Surge serverar filen när det inte finns någon direkt matchning för den begärda URI.
Annonsering
Lösenordsskydd är aktiverat av en AUTH-fil. Detta accepterar en enkel lista med användarnamn och lösenord.
cloudsavvy: howtogeek
Du uppmanas att ange ett användarnamn och lösenord med HTTP Basic Authentication varje gång du besöker din webbplats. Den här funktionen är endast tillgänglig på den betalda Surge Plus-planen.
En annan Surge Plus-funktion är regler för manuell routing. Du kan skapa en ROUTER-fil för att definiera anpassade omdirigeringar, antingen på din webbplats eller externt.
301/flyttad sida/ny länk
Surge stöder 301 (flyttas permanent) och 307 (flyttas tillfälligt) statuskoder för den första kolumnen. Den sista kolumnen kan vara en relativ länk på din webbplats eller en absolut länk till en annan domän (https://www.google.com).
En slutlig konfigurationsfil är CORS. Detta låter dig tillåta gränsöverskridande åtkomst till din webbplats. Lägg till en * i filen för att acceptera förfrågningar från alla ursprung. Du kan istället skriva enskilda domäner för att begränsa det tillåtna ursprunget.
Automatisera Surge Deployments
Surge styrs helt av textfiler och terminalkommandon. Det är enkelt att integrera i CI-rörledningar för att automatiskt distribuera webbplatser vid varje engagemang.
Annonsering
Automating Surge kräver användning av API-tokens. Detta låter dig undvika de interaktiva inloggningsanvisningarna. Logga först in på Surge på din utvecklingsmaskin. Kör surge token för att få din API-token.
Ställ in miljövariablerna SURGE_LOGIN och SURGE_TOKEN i din CI-pipeline. Den förra bör vara din e-postadress medan den senare tar din API-token. Nu kan du distribuera icke-interaktivt med flaggorna –project och –domain:
surge –project $ PWD –domain example.com
Sammanfattning
Surge gör det enkelt att få statiska webbplatser live på webben. Bastjänsten är gratis att använda. Uppgradering till Plus-planen ger dig autentisering, omdirigeringar och mer konfigurerbar HTTPS.
Till skillnad från andra utmanare är Surge helt terminalstyrd. Detta gör den idealisk för snabba utvecklarcentrerade webbplatser som hanteras via Git-förvar och CI-rörledningar. Det minskar serverkonfigurationen så att du kan fokusera på att bygga webbplatsens innehåll.
För mer avancerade användningsfall kan Surge till och med lägga till flera bidragsgivare. Kör surge – lägg till user@example.com för att ge vänner, gäster och kollegor åtkomst till din webbplats. De kommer att kunna distribuera genom att köra överspänningar och tillhandahålla samma domännamn som du har använt.