Лучшее доступно

Vedmark

Категория "База знаний":

Инструкции и статьи на тему «как». Ответы на часто задаваемые вопросы наших клиентов и не только

Полезные ссылки по Flutter

ORM для dart (Flutter )

Кодогенерация

Публикация

  • Публикация на F-droid (кратная инструкция),
  • Консоль разработчика APKPure,
  • Страница со ссылкой для регистрации в качестве разработчика на slide.me,

Быстрый старт со svelte

  • npx degit sveltejs/template my-svelte-project — развернуть шаблон svelte приложения
  • npx degit sveltejs/template my-svelte-project && cd my-svelte-project && node scripts/setupTypeScript.js — развернуть шаблон svelte с поддержкой typescript
  • npx svelte-kit dev — развернуть проект sveltekit
  • npx degit "sveltejs/sapper-template#rollup" my-app — развернуть sapper app (legacy)

Полезные плюшки:

  • SPA-роуты для svelte (svelte-spa-router) (навигация только по хэшу)
  • tinro — легковесные svelte routers. Пример использования.
  • svelte-router. (svelte-router-spa)
  • svelte-router. (svelte-router) — малоизвестные, мало звезд. Вдохновлен vue router

Полезные ссылки:

Ликбез по pacman

  • pacman -u — обновить список пакетов
  • pacman -S <packname> — установить пакет
  • pacman -R <packname> — удаление конкретного пакета

Docker справочник cli

  • docker images — показать все локальные образы docker
  • docker rmi [-f] <id|label> — удалить образ c локальной машины
  • docker rmi -f $(docker images -q) — удалить все докер образы
  • docker build [-t <label>] <path> — построить образ на основе докерфайла
  • docker run [-dt] [--name <name>] [-v <path:path>] [-p <port:port>] [--...] <id|label> [cmd] — запустить образ в контейнере c cmd-командой (необязательно)
      • -d — в фоновом режиме
      • -t — прикрепляет к контейнеру терминал
      • -i — перенаправляет ввод/вывод на текущий терминал
      • --name — явно указать имя контейнера, по которому можно будет обращаться к нему (иначе будет сгенерировано рэндомно)
      • -p <external_port:internal_port> — проброс портов
      • -v --volume <external_path:internal_path> — монтирует папки хоста в контейнер
      • --rm — удаляет контейнер после завершения работы
      • --memory <n> — позволяет указать количество ОЗУ, доступной контейнеру
      • -P — пробрасывает все порты контейнера в хост-систему
      • --expose — позволяет пробросить несколько портов из контейнера в хост-систему
      • -e <"FOO=bar"> — добавляет переменную окружения в контейнер
  • docker ps [-a] — показать все запущенные [существующие] докер контейнеры
  • `docker ps -q | xargs docker stats —no-stream` — посмотреть ресурсы, потребляемые запущенными контейнерами
  • docker stop <name> — останавливает указанный образ (с сохранением данных)
  • docker kill <name> — то же самое без сохранения данных
  • docker rm <name> — удаляет указанный контейнер
  • docker attach <name> — подключиться к выбранному докер-контейнеру
  • docker exec [-ti] <name> <cmd> — выполняет команду в докер-контейнере
  • docker push <imagename> — отправить образ в удаленный реестр
  • docker ps -q | xargs docker stats --no-stream — посмотреть нагрузку на процессор и память каждого из контейнеров
  • docker stats — похожа на предыдущую команду, но более короткая
  • docker info --format '{{.LoggingDriver}}' — посмотреть используемый по умолчанию лог драйвер (json-file)
  • docker logs [<container_name>] [-f --tail 100] — показать логи [конкретного контейнера] в терминал [последние 100 строк]
  • docker inspect --format='{{.LogPath}}' <containername> -показать, где хранятся логи для конкретного контейнера

Деплой на heroku

Развертывание:

Heroku — достаточно крутой сервис. У них есть свой собственный cli, который включает в себя множество консольных инструментов, в том числе для работы с git, docker и ssh.  И есть несколько способов деплоя приложения:

  • Деплой непосредственно в dynos-ы — легкие изолированные контейнеры (environments) с использованием готовых buildpack-ов. На странице быстрого старта есть достаточно простые инструкции, которые позволят автоматически развернуть бойлерплейт популярного фреймворка с со страницы хероку на гитхабе, внести несколько изменений и задеплоить на сервер (например, для джанго). Особенности:
    • Деплой статики через whitenoise
    • Медиа файлы (и, вероятно, файлы в целом) не сохраняются в контейнере (не проверено)
    • Не поддерживает sqlite (не проверено)
    • Дефолтная бд — postgresql
    • Дополнительные сервисы системы можно устанавливать только в рамках существующих buildpack-ов
  • Деплой через docker — это деплой готового докер-контейнера.

 

Список основных команд:

  • heroku login — залогиниться на сервере heroku с локальной машины
  • heroku create [--buildpack heroku/buildpackname]— создать новое приложение heroku: cоздает новое приложение c репозиторием на сервере heroku и одновременно добавляет ссылку на удаленный репозиторий в локальный git remote
  • git push heroku main — обычная git push команда, которая отправит на heroku изменения и автоматически запустить pipline (для django по дефолту pip install -r requirements && python manage.py collectstatic и запуск/перезапуск веб-сервера (по дефолту gunicorn))
  • heroku logs --tail — показать последние логи с сервера (терминальную сессию)
  • heroku ps — показывает остаток по месячной квоте и список запущенных процессов
  • heroku ps:scale web=1 — запустить buildpack, указав явно тип;
  • heroku ps:scale web=0 — остановить buildpack c явным указанием типа, предопределенного в Procfile.
  • heroku open — открыть приложение в браузере
  • heroku local web — запустить web buildpack локально на сервере разработки
  • heroku addons  — посмотреть расширения (addons) приложения на heroku (по дефолту только postresql). Addons — это преопределнные доступные удаленные сервисы на хероку, которые работают независимо от вашего dynos (либо контейнера)
  • heroku addons:create <add-on name> — добавить add-on.
  • heroku run <cmd> — запустить linux приложение или shell скрипт в терминале dynos, перенаправив ввод/вывод на текущий терминал
  • heroku config:set VARNAME=value [-a <appname>] — устанавливает переменную окружения на сервере [для конкретного приложения, например blooming-hollows-52049]
  • heroku config — посмотреть все переменные окружения. По дефолту содержит DATABASE_URL c атрибутами дефолтной базы данных
  • heroku pg — посмотреть детальную информацию об используемой базе данных (postgres). См так же heroku pg:psql
  • heroku buildpacks:set <heroku/buildpack_name> — установка buildpack для приложения
  • heroku buildpacks:remove <heroku/buildpack_name> — удалить buildpack из приложения
  • heroku buildpacks:clear — сбросить на дефолтный buildpack
  • heroku buildpacks:add --index 1 <heroku/nodejs> — добавить дополнительный пакет сборки
  • heroku buildpacks — посмотреть все установленные buildpack-и текущего приложения
  • heroku help buildpacks — справка по команде buildpacks;
  • heroku plugins:install heroku-builds — установка плагина (не должен превышать квоты 500 мб)
  • heroku container:login — авторизоваться в реестре контейнеров heroku
  • heroku container:release [-a evening-tundra-50688 web] — полагаю, что запустить контейнер [для конкретного приложения с указанным типом]
  • heroku stack — посмотреть какой стэк использует ваше приложение
  • heroku stack:set <stackname> -a <appname> — установить стэк для приложения, например `heroku stack:set container -a evening-tundra-50688`
  • `heroku update beta`  — обновить heroku до beta (либо обновить канал бета (прим. переводчика))
  • `heroku git:remote -a <appname>` — насколько я понял, добавить ссылку на удаленный репозиторий хероку в приложение
  • `heroku auth:token` — авторизоваться через сторонний сервис

Особенности бесплатного хостинга:

  • ограничение по времени работы до 550 часов в месяц
  • сервер засыпает после секунд простоя, следующий запрос будет дольше (вероятно, несколько секунд)
  • ограниченный размер — до 500 мб
  • домен третьего уровня (можно докупить отдельно)

Дополнительно:

Полезные ссылки:

  • Деплой на heroku джанги через докер
  • Какой-то плагин для развертывания приложений джанго на heroku (не испытывал)

Настройка postgresql с django

Установка Postgresql

  • Для начала установим саму postgresql и ее утилиты cli 
    sudo apt install postgresql postgresql-contrib
  • По дефолту posgresql развернется с пользователем postgres. Теперь можно переключиться на пользователя postgres: sudo -i -u postgres и войти в консоль postresql: 
    psql
  • Задаем пароль для текущего пользователя \password postgres
  • Выходим командой \q и создадим новую базу данных так: 
    createdb <dbname>

    либо так из cli psql:

    create database first_db owner hostgeek_db;
  • Cоздадим нового пользователя postgresql: 
    createuser --interactive

    либо так из cli psql:

    create user <hostgeek_db> with password <'testpassword18'>;

Другие команды postgresql:

  • \q — выход
  • `\conninfo` — инфо о текущем пользователе
  • sudo -u postgres psql — вход в консоль postgresql одной строкой

 

Полезные ссылки: установка postgresql на linux, и настройка с джангой,

django cli

Команды cli для django

  • py manage.py createapp [appname]  — создать новое приложение в текущем проекте
  • py manage.py makemigrations [--empty] [appname]  — генерация [шаблона] файла миграции [в приложении]
  • py manage.py showmigrations [appname]  — показать состояние миграций [конкретного приложения]
  • py manage.py migrate [appname] [migration_name]  — генерация схемы БД на основе [файлов миграций] моделей [либо откат миграции к migration_name , которая совпадает с именем файла миграции]
  • py manage.py migrate [appname] --fake  — отметить миграции [для конкретного приложения] как выполненные
  • python manage.py sqlmigrate <appname> <migration_name> — показывает, какие sql-запросы генерируются конкретной миграцией
  • py manage.py createsuperuser — создание супер администратора
  • py manage.py test [packname] — запуск тестов [конкретного пакета/приложения] проекта
  • py manage.py collectstatic — объединение всех статических файлов
  • py manage.py dumpdata [appname[.model]] [--format xml] > dump.json — сделать дамп базы данных
  • py manage.py loaddata mydata.json — загрузить данные из дампа
  • py manage.py flush — удаляет все данные из базы данных
  • py manage.py dbshell — войти в командную оболочку используемой базы данных
  • python manage.py check [appname] — сделать проверку на распространенные ошибки
  • python manage.py changepassword <user_name> — сменить пароль пользователя
  • py manage.py help — показать список всех доступных команд

Дополнительно:

cli для sqlite:

(sqlite3)

  • sqlite [db_filename] .dump > dump.sql — сохранить дамп базы данных в файл либо из shell: 
    .output dump.sql
.dump
  • sqlite3 [db_filename] < dump.sql — загрузить из дампа в базу данных. Либо из shell 
    .read dump.sql

cli для mysql:

(`mysql`)

Удалить все таблицы из базы данных, не удаляя саму БД:

DROP DATABASE coding_skills_new;
CREATE DATABASE coding_skills_new;

cli для pgsql:

(psql)

Конверторы между базами данных

  • mysqltosqlite конвертор — конвертирует дамп из mysql в sqlite-совместимый формат
  • mysqltopgsql конвертор — конвертирует дамп из mysql в pgsql-совместимый формат

Удалить все таблицы в postgres, не удаляя саму базу данных (полезно при ремиграциях с нуля):

DROP SCHEMA public CASCADE;
CREATE SCHEMA public;

PS:

Экспорт и импорт данных в джанго

При миграции джанго вы можете столкнуться с тем, что необходимо сделать неполный дамп и накатить его на пустую бд, например, так: `py manage.py dumpdata —exclude=relevance_tests —indent 4 > dump.json`. Однако, на практике это может оказаться не так просто и вас могут поджидать множество `UNIQUE` и FOREIGN constraint failed: django_site.domain , поскольку джанга будет следить за целостностью данных и уникальностью ключей. А прежде, чем накатить данные, вам необходимо будет сделать миграции для новой бд:

py manage.py migrate

Однако миграции не просто создают схему для базы данных, но и заполняют некоторые из этих таблиц. А именно auth_permission, sites и content_types, и при попытке записать данные поверх уже существующих данных с теми же ключами, мы имеем то, что имеем. Поэтому при дампе эти таблицы необходимо исключить приложения:

py manage.py dumpdata --exclude=sites --exclude=contenttypes --exclude=my_app --indent 4 > dump.json

Второй нюанс заключается в кодировке. В моем случае получившийся дамп надо было вручную перегнать в utf-8, иначе loaddata его принимала.

Есть и еще один нюанс. В примере выше, вы вероятно, заметили, что я не перечислил приложение auth, в котором лежит модель permissions, и сделал это сознательно, поскольку хотел экспортировать пользователей. Теперь чтобы избежать конфликта ключей, для loaddata необходимо явно исключить таблицу permission из:

py manage.py loaddata --exclude=auth.permission data.json

Так же стоит обратить внимание на ключ —natural-foreign. В официальной документации рекомендуют его использовать при дампе Permission и ContentType моделей.

Утилиты linux

rsync

  • -v — выводит подробную информацию о процессе копирования;
  • [-a] — сохраняет все атрибуты оригинальных файлов;
  • -u — не перезаписывать более новые файлы;
  • -l — копирует символьные ссылки;
  • -L — копирует содержимое ссылок;
  • -p — сохраняет права для файлов;
  • -t — сохраняет время модификации;
  • -e — использовать другой транспорт, например, ssh;
  • [-z] — cжимает файлы перед передачей;
  • —recursive — перебирать директории рекурсивно;
  • —exclude — Исключить файлы по шаблону;

Примеры:

  • rsync -avz skillproject/data/ . — из подкаталога в текущий каталог
  • rsync -avz skillproject/data/ aaa/ — из подпапки в подпапку aaa/
  • rsync -avz skillproject/data/ digita6d@digita6d.beget.tech:/home/d/digita6d/code-skills.ru/public_html/sources/skillproject/data/ — передача на удаленный сервер
  • rsync -avze ssh skillproject/data/ digita6d@digita6d.beget.tech:/home/d/digita6d/code-skills.ru/public_html/sources/skillproject/data/ — то же самое м явным указанием ssh

ss

  • -l или —listening — посмотреть только прослушиваемые порты;
  • -p или —program — показать имя программы и ее PID;
  • -t или —tcp — показать tcp порты;
  • -u или —udp показать udp порты;
  • -n или —numeric показывать ip адреса в числовом виде.

Примеры:

  • ss -tlpn — проверить все прослушивающие tcp-порты
  • ss -tulpn | grep :80 — показать все процессы, работающие на 80-м порту

ps

  • ps -e — показать все процессы
  • ps -ef — показать подробную информацию о каждом процессе
  • ps -ef | grep phantom — найти все процессы с именем `phantom`

mpstat

Показывает статистику загрузки процессора. Команды:

  • mpstat — показывает общую информацию
  • `mpstat -P ALL`  — по каждому ядру

free

Показывает потребление ОЗУ на текущий момент:

  • free -h — показывает информацию в гигабайтах (более человеко читаемо, чем в байтах)

top

Что-то наподобие диспетчера задач, только для линукс, показывает попроцессное потребление озу

dpkg

Пакетный менеджер для debian систем (не путать с системой управления пакетами — apt/apt-get)

  • dpkg -s <packname> — проверить, установлен ли пакет
  • dpkg -l — список всех пакетов
  • dpkg -l | grep apache2 — проверить, установлен ли конкретный пакет
  • dpkg -i <package.deb> — установить пакет

 

netstat

  • netstat -pnltu — посмотреть список используемых портов

См так же краткий ликбез.

Основы pip

Шпаргалка для pip

  • pip install package_name [package_name [package_name]] — установить пакет или список пакетов
  • pip install package_name==x.x — установить пакет конкретной версии
  • pip install -r requirements.txt — установка пакетов из указанного файла
  • pip install git+https://github.com/Sanshain/tortoise-orm.git[@name] — установить пакет с гитхаб
  • pip freeze > requiremrnts.txt — сохранить список пакетов окружения в файл
  • pip list — вывести список пакетов в консоль
  • pip install [package_name ] -U — обновить пакет
  • pip uninstall package_name [package_name [package_name]] — удалить пакет или список пакетов
  • pip show package_name — показать зависимости пакетов
  • pip -V — показать установленную версию pip

DLang. Быстрый старт

Полезные ссылки

  • Опции cli при компиляции и сборке через пакетный менеджер dub,
  • Составление конфиг-файла для dub-проекта,
  • Опции cli компилятора dmd,
  • Ссылка на lldb-mi дебаггер
  • Ссылка на mago-mi дебаггер (у меня завелся только под Windows для x86 сборок либо как интегрированный в DLangIDE (чуть чуть удобнее блокнота, автокомплит  только после точки), в рамках последнего работает частично — показывает значения только для значимых типов)
  • Пример использования gdb (поставляется вместе с gcc) в консоли. На примере nim наглядно. Отлично интегрируется в VSCode на линукс (рекомендуется).
  • Ссылка на ldc2 компилятор
  • Ссылка для gdc (для Windows только x64)
  • Предкомпилированные константы для условной компиляции

Замечания автора

  • С intelligeIdea автокомплит у меня так и не заработал либо я не разобрался (зато есть подсветка синтаксиса и удобная настройка опций компилятора в ui ( которые не уверен,что применяются )
  • С VisualD не заработала отладка (автокомплит включается в настройках, ограниченный, но есть подсказка доков однотонным шрифтом. В VSCode подсказки лучше, но можно использовать как простенький редактор)