Как да хоствате леки приложения безплатно

Когато търсите услуги за уеб хостинг, има много безплатни опции. Но няма толкова много места, където можете да хоствате уеб приложения с пълен стек, които включват API, CGI или AJAX бекенд заявки - особено ако искате да използвате нещо различно от PHP.

Тази статия е просто, но смислено ръководство за "разходка, преди да можете да стартирате" за това как да започнете с хостинг на вашите скриптове на облачни сървъри.

Кога да използвате платформа за облачни приложения

Платформите за облачни приложения работят добре в сценарии, при които се нуждаете от малко код, за да стартирате на сървър. Много от тези платформи предлагат поредица от базирани на Linux контейнери за приложения (които изглеждат като виртуални машини), където разполагате кода, който сте разработили на вашия локален компютър с набор от ключови думи от командния ред.

Heroku е една такава услуга, която можете да използвате за хостване на вашия код (на различни езици) относително лесно. Той предлага безплатен модел, при който ви позволяват да използвате около 500 часа изчисления безплатно (пълните цени са тук).

След като напишете кода си на локалния работен плот, можете да изпълнявате команди, които разполагат кода върху работно пространство в Heroku. След това кодът се изпълнява в зависимост от задействане. Задействанията могат да бъдат планирана работа, уеб сървър, който се задейства чрез заявка за уеб страница, или нещо, което се изпълнява постоянно и обработва данни - което може да стане доста скъпо.

Наистина хубавото е, че не е нужно да се притеснявате за операционната система (памет, съхранение, процесор, кръпки за сигурност), тъй като всичко това се управлява за вас - но в същото време това означава, че имате ограничена гъвкавост, тъй като не разпределяйте ресурси директно.

Някои конкретни примери, в които Heroku може да работи добре за вас:

  • Хостинг на вашия собствен уебсайт, където искате да напишете свой собствен уеб сървър
  • Периодично изстъргване на данни от уебсайт и след това съхранение в база данни за анализ
  • Предлагане на API сървър за конкретна задача. Неща като предлагане на данни за времето, съхраняване на данни от сензора на Internet of Things или обаждане в уеб услуга за модел на машинно обучение
  • Услуга за бази данни (въпреки че услуга като Firebase вероятно е по-подходяща)

Архитектура на Heroku

Heroku предоставя лека виртуална машина (VM), за да можете да внедрите кода си. Имайте предвид, че при безплатната опция можете да разположите до 5 приложения, които се считат за 5 леки виртуални машини. За вашето действително приложение ви се предоставя отделен поддомейн URL под Heroku. Така че имената на вашите проекти трябва да бъдат уникални.

Тези работни пространства имат собствено пространство за компоненти като: файлове с код и ресурси (не файлове с динамични данни), база данни (Postgres) и регистрационни файлове.

На вашия локален работен плот Heroku използва името на вашата директория, за да дефинира вашия проект, а също и за Heroku да разбере вашия контекст. Така че можете да имате множество проекти в различни директории и когато стартирате командите Heroku - просто се уверете, че го правите в правилната папка.

Единственото ключово нещо, за което трябва да сте наясно (което открих по трудния начин през часове за отстраняване на грешки - бих искал да обърна повече внимание на документацията), е, че всичко се изпълнява от паметта. Няма постоянно съхранение. Ще го повторя отново - не можете да съхранявате никакви файлове на файловия сървър! За постоянство Heroku предлага SQL база данни след хода, където можете да добавяте записи според нуждите.

Прост пример - откриване на промени в уебсайта

Ето ръководство стъпка по стъпка, за да получите работещ пример за проста услуга, която ще ви изпрати имейл, ако даден уебсайт се е променил - основно клонинг на www.changedetection.com. Ще има няколко ключови компонента на това:

  1. База данни, която ще съхранява: (а) имейл адреса за уведомяване за променен уебсайт; (б) уебсайта за проследяване; (в) последното „копие“ на уебсайта
  2. Код, който ще провери даден уебсайт от базата данни в # 1 (Python script)
  3. Планировчик на работа, който ще стартира програмата в # 2 (еквивалент на cron работа)
  4. Уеб потребителски интерфейс, където можете да добавяте / изтривате уебсайтове за наблюдение в базата данни, посочена в # 1
  5. Механизъм за изпращане на имейли

Разбирането на тези компоненти ще ви въоръжи с уменията да правите много неща вече. Научих всички тези неща от множество източници, така че това действа като консолидиран пост.

Предположения

Следното ръководство прави следните предположения:

  • Имате акаунт в GitHub - ако нямате, моля, създайте си тук. Вие също трябва да прочетете това просто ръководство.
  • Вече имате акаунт Heroku - ако не го създадете, моля, създайте го тук.
  • Използвате машина с Windows - ако не, добре е, инструкциите са доста подобни в други среди
  • Вече имате инсталиран Python - ако не го направите, моля, отидете тук, за да го инсталирате
  • Вече можете да програмирате в Python - ако не, тогава бих ви предложил първо да научите някои от основите. Някои ръководства са тук.
  • Знаете SQL - ако не знаете, моля, отидете тук.

Преглед на стъпките

Намирам, че преминаването през „разходка, преди да можеш да тичаш“ помага за учебния процес. Той също така служи като документация за себе си за това как да решите всяко парче от по-големия процес. По този начин, ако нещо се счупи във вашето бъдещо начинание, имате по-голям шанс да разберете къде се е объркало.

Стъпка 1 : Разработете уеб потребителския интерфейс - първо изградете Hello World

Стъпка 2 : Постоянство - създайте база данни

Стъпка 3 : Проверете уебсайтовете за промени

Стъпка 4: Изпратете известие по имейл за промени

Стъпка 5 : Изведете изхода на уеб страницата

Стъпка 6: Разполагане

Стъпка 1: Разработете уеб потребителския интерфейс - първо изградете Hello World

First, let’s get a simple program deployed onto Heroku to get things started. This program will be a precursor to the web user interface (item #4) in the components list above. In order to serve up a page, we could simply have an HTML page, but then we would need to have a web server to server that file. In other words, when you type in the URL of the website, a program would need to interpret the request, then provide the contents of the HTML file. You can create your own mini web server with the Flask Python library, which is what we’ll do.

  • Create a folder called webchecker and go into that directory (this directory name does not have to be the same as the Heroku application name)
  • Install the Flask library. Enter the command: npm Flask
  • Create the following Python program and name it showchecks.py:

Before you deploy to Heroku, test that it works on your local PC. You can test it with the following steps:

  • Run the program: python webchecker.com
  • Open up your browser on your local pc and open up the page: //localhost:5000/hello

Next, let’s deploy this to Heroku. Before you can deploy, there needs to be a few more files that need to be included to help Heroku know more about your application.

First, the requirements.txt

Second, the file to tell Heroku what to run when a webrequest is made:

Finally, the runtime version of Python to use (default is 2.7, but we want to specify the latest version of Python):

Hence, you should have four files:

  1. showchecker.py which is the code
  2. requirements.txt for the list of non-standard library dependencies. Whenever you have new libraries which are not part of the Python Standard Library — i.e. you need to install them using a tool such as “pip” — then add these here. You can find the version of an installed library such as Flask by running the command: pip show Flask in the command line
  3. Procfile which is the actual Python script to run when the website is called — make sure to update this if you change the Python file
  4. runtime.txt which is the actual version of python to use

You can deploy with the following steps from the command line:

  1. heroku create webchecker01 — buildpack heroku/python
  2. git add *.* *
  3. git status
  4. git commit -m “all files”
  5. git push heroku master

For the command #1 (heroku create…), the “webechecker01” part is the unique name you’ll need to provide for the name of the app.

For command #3 (git status) this will tell you what files are ready to be deployed. Make sure all files are there, if not add them using git add me>.

Now you can check your website: .herokuapp.com/hello

Original text


Let’s also make sure we can see the logs since this is a great way to see what’s going on with your app server. On your PC and in the webchecker directory, run the command: heroku logs

You’ll see the last execution steps. If things aren’t working as expected, this is your first stop to find out more detail.

You can also go to the Heroku dashboard to see your consumption:

//dashboard.heroku.com

Step 2: Persistence — create a database

In order to make more useful programs, you’ll need to have a data store of sorts. This is where the Postgres database service comes into play. You first need to deploy the Heroku database service, then create your tables, and finally be able to connect to the database from your code locally (for testing).

To deploy a database service, first create it using the following command:

heroku addons:create heroku-postgresql:hobby-dev

Next, access the database from the command line and create your tables. The database is created on the Heroku cloud service and not locally. However, you can access it through the command line. To log on to the database via the console, run the command heroku pg:psql. Remember, you have to do it in your webchecker folder so that Heroku knows that it is the database for the webchecker site.

To see the list of tables type the command \d

To create a table, you need to use normal SQL statements. For our webchecker program, let’s create a table with the following columns:

  • ID — automatically generated ID for each entry (this will be the primary key). This is done by using the type “serial”
  • website — the website to monitor
  • emailaddress — the email address to send the notification that a change has occurred
  • lasthashcode — we won’t store a copy of the whole webpage, instead we will generate a hash based on the HTML of the page, and then compare this each time. This is more efficient storage-wise, but will not tell us what actually changed
  • lastchangedate — the date that the web changed last time. Hence we will get the database to default this with the current date

To create this table, enter the following command in the Heroku Postgres database console:

CREATE TABLE webcheckerdb (id serial, website varchar(250), emailaddress varchar(250), lasthashcode varchar(32), lastchangedate timestamp DEFAULT current_date );

(Make sure you include the semicolon at the end!)

Next, let’s insert a single record in the database to ensure we have something to work with prior to getting our web UI up and running (you can use your own email address so it works in the future):

INSERT into webcheckerdb values(DEFAULT, 'news.google.com', '[email protected]', '', DEFAULT);

(Make sure you include the semicolon at the end!)

You can quit with \q.

Step 3: Check websites for changes

First, let’s get a piece of code to at least check if a hardcoded site can be retrieved (following on the concept of walking before running).

Hence, first step is to see if we can retrieve a webpage, hash it, and then compare it to a hardcoded hash. Create a new Python file called checkwebsite.py. Code here:

Running this will output the following:

If you have any errors with missing libraries, you can add them via: pip install ry> from the command line.

Next, let’s connect to the database with the following code:

When you try to run this code, you are likely going to get an error of the form KeyError: ‘DATABASE_URL’. This is because your Python code is trying to locate the web address of the Postgres database hosted on Heroku. This is automatically updated to the environment variable DATABASE_URL in the Heroku server. However, on your local PC you will have to do this manually:

  1. heroku config
  2. set DATABASE_URL=

Step 4: Send an email notification on changes

Final step is to send an email. To do this, you’ll need to install an Addon that has the ability to send emails — you can find these via the Heroku marketplace: //elements.heroku.com/addons

In here, there is an Addon called SendGrid: //elements.heroku.com/addons/sendgrid

You can add SendGrid to your app in the command line by typing:

heroku addons:create sendgrid:starter

When you go to your dashboard you can see the new Addon in the Resources section:

Before using it, you’ll need to create an API key. Double click the SendGrid component above and go into Settings->API Key->Create Key (blue button on top right).

Once you create the key, copy it and go back to the command prompt and enter:

heroku config:set SENDGRID_API_KEY=ve>

This will only register it on the server, you need to add it locally to your desktop with:

set SENDGRID_API_KEY=in>

Once done, you can test your code in a new Python script called sendmail.py. Install the library via pip install sendgrid:

To confirm the email was sent and delivered, you can go back to the SendGrid dashboard and checking the Statistics Overview screen:

When checking your email, remember to check your spam.

Once it is working, there are only two lines of code you need to add to your main checkwebsite.py script. It is:

import sendmail #import the send email subroutine you wrote above
...
#call the subroutine after find the hashcode has changedsendmail.sendemail(webrecord['emailaddress'], 'Website changed', webrecord['website'] + ' changed')

The full code is here:

Step 5: List the output on the web page and schedule the job

The next step is to list the output on the webpage.

This involves querying the database, and then cycling through and showing the data on your screen. Hence, it takes the ‘Hello World’ code above, and makes the modification. I also created a different path for this, so to test this out you’ll need to go to the URL: //localhost:5000/list

And here’s the output:

Step 6: Deploy

The final step is to deploy everything to Heroku and then schedule the job so that it checks email.

You should have the following files:

  1. Procfile — the file which points to showchecker.py
  2. requirements.txt — the file which contains the library dependencies
  3. runtime.txt — the version of python
  4. showchecker.py — the python code which shows the database output on the web via .herokuapp.com/list
  5. checkwebsite.py — the python code that checks for any changes on the websites

For the requirements.txt, you will need to make amendments to add the latest libraries:

Deploy these all to Heroku:

  1. git add *.* *
  2. git commit -m “deployment”
  3. git push heroku master

Test each component:

  1. Go to .herokuapp.com/hello
  2. Go to .herokuapp.com/list

If there are any errors, then run heroku logs in the command line to see what is going on.

Next, run the checkwebsite.py directly on Heroku to make sure there are no issues. To do this, you can type:

heroku run python checkwebsite.py

Finally, you can now schedule your job. Again, you need to include an Addon to do this.

heroku addons:create scheduler:standard

And you should be able to see the scheduler in your resources page:

You can simply use the command line to run the program, in our case it is: python checkwebsite.py (this is the same as what we tested above with the heroku run command).

Summary

And that’s it… the first time it is a little complex, but hopefully the above incremental steps will help you understand what’s going on under the hood. There are a lot more resources on Heroku as well as a wealth of information on Stack Overflow. These resources should make a lot more sense after going through the above.

Good Luck!

Thanks for reading! If you like what you read, hit the❤ button below so that others may find this (you can also find me on Twitter )