Quickstart
editQuickstart
edit-
Apply the following specification to deploy Enterprise Search. ECK automatically configures the secured connection to an Elasticsearch cluster named
quickstart
, created in Elasticsearch quickstart.cat <<EOF | kubectl apply -f - apiVersion: enterprisesearch.k8s.elastic.co/v1 kind: EnterpriseSearch metadata: name: enterprise-search-quickstart spec: version: 8.15.3 count: 1 elasticsearchRef: name: quickstart EOF
Workplace Search in versions 7.7 up to and including 7.8 required an Enterprise license on ECK. You can start with a 30-day trial license.
-
Monitor the Enterprise Search deployment.
Retrieve details about the Enterprise Search deployment:
kubectl get enterprisesearch
NAME HEALTH NODES VERSION AGE enterprise-search-quickstart green 1 8.15.3 8m
List all the Pods belonging to a given deployment:
kubectl get pods --selector='enterprisesearch.k8s.elastic.co/name=enterprise-search-quickstart'
NAME READY STATUS RESTARTS AGE enterprise-search-quickstart-ent-58b84db85-dl7c6 1/1 Running 0 2m50s
-
Access logs for that Pod:
kubectl logs -f enterprise-search-quickstart-ent-58b84db85-dl7c6
-
Access Enterprise Search.
A ClusterIP Service is automatically created for the deployment, and can be used to access the Enterprise Search API from within the Kubernetes cluster:
kubectl get service enterprise-search-quickstart-ent-http
Use
kubectl port-forward
to access Enterprise Search from your local workstation:kubectl port-forward service/enterprise-search-quickstart-ent-http 3002
Open
https://localhost:3002
in your browser.Your browser will show a warning because the self-signed certificate configured by default is not verified by a known certificate authority and not trusted by your browser. Acknowledge the warning for the purposes of this quickstart, but for a production deployment we recommend configuring valid certificates.
Login as the
elastic
user created with the Elasticsearch cluster. Its password can be obtained with:kubectl get secret quickstart-es-elastic-user -o=jsonpath='{.data.elastic}' | base64 --decode; echo
-
Access the Enterprise Search UI in Kibana.
Starting with version 7.14.0, the Enterprise Search UI is accessible in Kibana.
Apply the following specification to deploy Kibana, configured to connect to both Elasticsearch and Enterprise Search:
cat <<EOF | kubectl apply -f - apiVersion: kibana.k8s.elastic.co/v1 kind: Kibana metadata: name: quickstart spec: version: 8.15.3 count: 1 elasticsearchRef: name: quickstart enterpriseSearchRef: name: enterprise-search-quickstart EOF
Use
kubectl port-forward
to access Kibana from your local workstation:kubectl port-forward service/quickstart-kb-http 5601
Open
https://localhost:5601
in your browser and navigate to the Enterprise Search UI.