![\"OpenSearch](\"https:\/\/www.oderland.se\/support\/wp-content\/uploads\/2024\/02\/opensearch_logo_default-1024x196.png\"){kind=logo}
<\/figure>\n\n\n\nVad \u00e4r OpenSearch och varf\u00f6r vill jag installera det?<\/h2>\n\n\n\n
OpenSearch \u00e4r en distribuerad s\u00f6k- och analysmotor baserad p\u00e5 Apache Lucene.<\/p>\n\n\n\n
Den anv\u00e4nds som ett verktyg f\u00f6r att hj\u00e4lpa till vid s\u00f6kningar, analyser och monitorering.<\/p>\n\n\n\n
Vissa system som t.ex. Magento, WordPress m.m. kan anv\u00e4nda denna f\u00f6r att snabba upp och g\u00f6ra s\u00f6k mer relevant.<\/p>\n\n\n\n
ElasticSearch eller OpenSearch?<\/h3>\n\n\n\n
Det v\u00e4ljer du sj\u00e4lv. OpenSearch \u00e4r en fork av ElasticSearch 7.10.2, dvs sista versionen innan ElasticSearch \u00e4ndrade sin licensform.<\/p>\n\n\n\n
Var hittar jag mer dokumentation om OpenSearch?<\/h3>\n\n\n\n
https:\/\/opensearch.org\/<\/a><\/p>\n\n\n\n Den h\u00e4r guiden beskriver hur du kan s\u00e4tta upp OpenSearch med en reverse proxy framf\u00f6r som hanterar automatiska certifikat och l\u00f6senordsinloggning.<\/p>\n\n\n\n Den tar dock ej upp hur man skapar upp ett kluster f\u00f6r OpenSearch, vilket \u00e4r rekommenderat om man skall k\u00f6ra det i produktion.<\/p>\n\n\n\n Den tar inte heller upp hur man brandv\u00e4ggar i Oderland Cloud<\/a> om du beh\u00f6ver l\u00e5sa ned access fr\u00e5n t.ex. en IP-adress, t.ex. om du vill begr\u00e4nsa access fr\u00e5n en annan Cloud server eller fr\u00e5n v\u00e5ra andra tj\u00e4nster som Managed Server<\/a>, Agency<\/a> eller Webbhotell<\/a>.<\/p>\n\n\n\n Vi skapar en server i Oderland Cloud med Docker och pekar ett v\u00e4rdnamn (t.ex. dom\u00e4n eller subdom\u00e4n) mot serverns nya ip-adress.<\/p>\n\n\n\n D\u00e4refter ssh:ar vi in till servern. Sedan skapar vi ett docker n\u00e4tverk som vi d\u00f6per till caddy. Det anv\u00e4nds till de containrar man vill f\u00e5 automatisk TLS (https:\/\/).<\/p>\n\n\n\n Vi skapar en mappstruktur samt en docker-compose.yml fil som talar om vilka tj\u00e4nster som skall k\u00f6ras och hur de skall konfigureras och anger samma v\u00e4rdnamn som vi pekat till servern.<\/p>\n\n\n\n Vi skapar upp ett l\u00f6senord med hj\u00e4lp av Caddy hash-password att anv\u00e4nda f\u00f6r basic auth i docker-compose.yml filen.<\/p>\n\n\n\n Sen startar vi upp v\u00e5r nya docker compose stack och testar att vi f\u00e5r certifikat och ett svar fr\u00e5n OpenSearch.<\/p>\n\n\n\n Skapa f\u00f6rst en server i Oderland Cloud med Docker, kika p\u00e5 en av guiderna nedan om du beh\u00f6ver hj\u00e4lp.<\/p>\n\n\n\n https:\/\/www.oderland.se\/support\/artikel\/sa-installerar-du-en-ny-server-med-docker-engine-i-oderland-cloud\/<\/a><\/p>\n\n\n\n https:\/\/www.oderland.se\/support\/artikel\/sa-installerar-du-docker-engine-i-oderland-cloud\/<\/a><\/p>\n\n\n\n Peka ett l\u00e4mpligt v\u00e4rdnamn<\/a> till serverns ipv4 adress. Du beh\u00f6ver g\u00f6ra det h\u00e4r steget f\u00f6r att vi skall kunna f\u00e5 ut ett TLS certifikat fr\u00e5n Letsencrypt automatiskt.<\/p>\n\n\n\n SSH:a in till servern.<\/p>\n\n\n\n Vi kommer att k\u00f6ra samtliga kommandon som debian anv\u00e4ndaren, men beh\u00f6ver anv\u00e4nda sudo ibland<\/p>\n\n\n\n B\u00f6rja med att g\u00e5 med i docker gruppen och aktivera den f\u00f6r din session.<\/p>\n\n\n\n Vi beh\u00f6ver ocks\u00e5 ut\u00f6ka vm.max_map_count d\u00e5 OpenSearch annars kan orsaka en del out of memory exceptions.<\/p>\n\n\n\n Skapa sedan ett docker n\u00e4tverk som vi anv\u00e4nder f\u00f6r de containers vi vill proxya via Caddy och automatiskt hantera Let’s Encrypt \/ Zero SSL f\u00f6r att f\u00e5 s\u00e4ker anslutning.<\/p>\n\n\n\n Vi anv\u00e4nder oss av hash-password fr\u00e5n Caddy f\u00f6r att hasha ett l\u00f6senord. Kopiera inte nedan rakt av, utan byt ut texten L\u00d6SENORDET till ett bra l\u00f6senor<\/strong>d som du sedan kommer beh\u00f6va anv\u00e4nda i din applikation f\u00f6r att ansluta till OpenSearch.<\/p>\n\n\n\n Vi ers\u00e4tter $ mot $$ med sed s\u00e5 att hashen skall fungera i docker-compose.yml, annars tolkas det som variabler.<\/p>\n\n\n\n Nu skapar vi mappen f\u00f6r docker-compose.yml filen och l\u00e4gger in texten nedan. Vi s\u00e4tter ocks\u00e5 max minnesanv\u00e4ndning f\u00f6r Javamotorn till 2GB ovan. Du kan beh\u00f6va h\u00f6ja detta samt serverns minne om du har stora index.<\/p>\n\n\n\n Har du pekat ett v\u00e4rdnamn som du vill anv\u00e4nda f\u00f6r servern eller f\u00f6r OpenSearch s\u00e5 kan du nu redigera kodsnutten ovan och \u00e4ndra HOSTNAME till ditt valda v\u00e4rdnamn. Du kan ocks\u00e5 g\u00f6ra det i efterhand med sed kommandot som vi visar nedan.<\/p>\n\n\n\n I demo-syfte s\u00e5 skapade vi os.oderland.cloud s\u00e5 att vi sedan kan g\u00e5 mot https:\/\/ os.oderland.cloud f\u00f6r att n\u00e5 OpenSearch. Exemplet ser d\u00e5 ut f\u00f6ljande med sed kommandot.<\/p>\n\n\n\n Starta sedan v\u00e5r nya docker compose stack.<\/p>\n\n\n\n D\u00e5 h\u00e4mtas samtliga images\/layers och sedan startar tj\u00e4nsterna upp.<\/p>\n\n\n\n Du kan f\u00f6lja loggen via: <\/p>\n\n\n\n Ja! Du b\u00f6r dock anv\u00e4nda dig av en snippet fr\u00e5n deras sajt<\/a> f\u00f6r att pluginen skall f\u00f6rst\u00e5 vilken version som anv\u00e4nds.<\/p>\n\n\n\nObservera<\/h3>\n\n\n\n
Utf\u00f6rande<\/h2>\n\n\n\n
F\u00f6rberedelser<\/h3>\n\n\n\n
Peka v\u00e4rdnamn (dom\u00e4n eller subdom\u00e4n)<\/h3>\n\n\n\n
Ut\u00f6ka virtuellt minne och g\u00e5 med i docker gruppen<\/h3>\n\n\n\n
sudo usermod -aG docker $USER\nnewgrp docker\necho 'vm.max_map_count=262144' | sudo tee -a \/etc\/sysctl.d\/opensearch.conf\nsudo sysctl -p<\/pre>\n\n\n\n
Skapa Docker n\u00e4tverk<\/h3>\n\n\n\n
docker network create caddy<\/pre>\n\n\n\n
Skapa ett hashat l\u00f6senord f\u00f6r Basic Auth till Caddy<\/h3>\n\n\n\n
docker run --rm lucaslorentz\/caddy-docker-proxy:ci-alpine hash-password --plaintext L\u00d6SENORDET|sed 's\/\\$\/\\$\\$\/g'\n<\/pre>\n\n\n\n
S\u00e4tt upp docker-compose.yml filen<\/h3>\n\n\n\n
Ers\u00e4tt HASHED_PASSWORD<\/strong> med l\u00f6senordshashen du fick ut ovan.<\/p>\n\n\n\nmkdir -p ~\/compose\/opensearch\ncat << EOF > ~\/compose\/opensearch\/docker-compose.yml\nversion: \"3.7\" \n \nservices: \n caddy: \n image: lucaslorentz\/caddy-docker-proxy:ci-alpine \n ports: \n - 80:80 \n - 443:443 \n environment: \n - CADDY_INGRESS_NETWORKS=caddy \n networks: \n - caddy \n volumes: \n - \/var\/run\/docker.sock:\/var\/run\/docker.sock \n - caddy_data:\/data \n restart: unless-stopped \n opensearch: \n image: opensearchproject\/opensearch:2.11.1\n volumes: \n - osdata01:\/usr\/share\/opensearch\/data\n environment:\n - \"cluster.name=opensearch-cluster\"\n - \"node.name=os-node01\"\n - \"discovery.type=single-node\"\n - \"bootstrap.memory_lock=true\"\n - \"plugins.security.disabled=true\"\n - \"OPENSEARCH_JAVA_OPTS=-Xms2G -Xmx2G\"\n labels:\n caddy: HOSTNAME\n caddy.reverse_proxy: \"{{upstreams 9200}}\"\n caddy.basicauth: \/*\n caddy.basicauth.admin: HASHED_PASSWORD\n networks:\n - caddy\n ulimits:\n memlock:\n soft: -1\n hard: -1\n nofile:\n soft: 65536\n hard: 65536\n restart: unless-stopped\n\nvolumes:\n osdata01:\n driver: local\n caddy_data:\n driver: local\n\nnetworks:\n caddy:\n external: true\nEOF<\/pre>\n\n\n\nAnge ditt v\u00e4rdnamn<\/h3>\n\n\n\n
sed -i 's\/HOSTNAME\/os.oderland.cloud\/g' ~\/compose\/opensearch\/docker-compose.yml<\/pre>\n\n\n\n
Starta upp OpenSearch och Caddy<\/h3>\n\n\n\n
cd ~\/compose\/opensearch\ndocker compose up -d<\/pre>\n\n\n\n
docker compose logs -f<\/pre>\n\n\n\n
Vanliga fr\u00e5gor<\/h2>\n\n\n\n
Kan jag anv\u00e4nda ElasticPress f\u00f6r WordPress ihop med OpenSearch?<\/h3>\n\n\n\n
N\u00e4r jag ansluter min Magento 2.4.x mot OpenSearch s\u00e5 klagar den p\u00e5 connection?<\/h3>\n\n\n\n