摘要：針對您的個人需要，有一些設(shè)置和任務(wù)可用來調(diào)整服務(wù)器，讓我們來探索它們默認端口號默認情況下，服務(wù)器在端口上啟動。

開發(fā)環(huán)境下運行Lagom
1.開發(fā)環(huán)境

Lagom的sbt或者maven項目是可以基于開發(fā)的環(huán)境允許使用單個命令來運行任意數(shù)量的服務(wù)。
當代碼更改時，同樣的命令也會重新加載服務(wù)，這樣你就不用手動重啟了，您可以繼續(xù)關(guān)注您的工作，并讓Lagom進行編譯和重新加載。
（1）運行Maven中的所有服務(wù)
命令很簡單，就是 lagom:runAll
如果您有很多服務(wù)，或者第一次檢索依賴關(guān)系,這可能需要一段時間，
(2)熱加載
一旦“Services started”消息出現(xiàn)，如果您對源代碼進行更改，您將在控制臺看到這樣的輸出:
[info] Compiling 1 Java source to //target/scala-2.11/classes...
--- (RELOAD) ---
（3）我們所看到的背后
當我們運行了runAll命令之后，在背后到底都發(fā)生了什么呢？？
    >啟動了一個嵌入式服務(wù)定位器(特別類似于zk或者eureka)
    >啟動了一個Cassandra服務(wù)器
    >開始了kafka服務(wù)器（這個比較熱了，mq系列）
    >你的服務(wù)開始
        >并向服務(wù)定位器注冊
這一切都是在沒有特殊代碼或附加配置的情況下自動發(fā)生的。
您可以通過在web瀏覽器中查看http://localhost:8000 / services來驗證您的服務(wù)正在運行（或者使用像curl這樣的命令行工具），服務(wù)定位器，在端口8000上運行，江湖返回類似于如下這樣的信息：
    [{"name":"hello-stream","url":"http://0.0.0.0:26230"},
     {"name":"cas_native","url":"tcp://127.0.0.1:4000/cas_native"},
     {"name":"hello","url":"http://0.0.0.0:24266"}]
cas_native是Cassandra服務(wù)器，正如您將在編寫持久和集群服務(wù)的文檔中學習的，Cassandra是Lagom的默認數(shù)據(jù)庫，它是開發(fā)環(huán)境的一個組成部分。
服務(wù)為定位器，Cassandra和kafka在接下來的章節(jié)中詳細討論。

2.運行服務(wù)

就像在上節(jié)講的那樣，在構(gòu)建中定義的所有Lagom服務(wù)都可以用單個任務(wù)來運行：runAll。執(zhí)行此任務(wù)時，將啟動嵌入式服務(wù)定位器，一個內(nèi)嵌的 Cassandra服務(wù)器也會隨之啟動，然后你的所有的服務(wù)都會并行的被啟動起來。而且，所有啟動的服務(wù)都將以熱重載模式運行。熱重新加載意味著服務(wù)會自動地重新加載您所做的每一個更改，這樣您就不必手動重新啟動它們。大多數(shù)時候，runAll任務(wù)將為您提供良好的服務(wù)。然而，有時您可能想手動啟動一些服務(wù)，這是當run 任務(wù)將派上用場的時候。run任務(wù)對每個Lagom服務(wù)實現(xiàn)項目都可用。
在Maven中，您可以使用Maven項目列表標記來執(zhí)行特定服務(wù)的run任務(wù):
    $ mvn -pl  lagom:run
您應(yīng)該記住的一點是，run只啟動特定的服務(wù)，它既不啟動服務(wù)定位器，也不啟動Cassandra服務(wù)器。因此，在手動啟動服務(wù)之前，您可能需要手動啟動服務(wù)定位器和Cassandra服務(wù)器。

3.端口是如何分配給服務(wù)的

在檢查運行服務(wù)列表時，您可能想知道端口是如何分配的。您應(yīng)該注意到的一點是，端口的分配是一致的，這意味著每個服務(wù)將得到分配的相同端口，這是真正有用的,它允許我們來編寫測試服務(wù)功能的測試腳本，甚至可以與與團隊的其他成員共享創(chuàng)建的腳本。即使在不同的機器上，同樣的端口也會被確定地選擇!注意，這里提醒一下，不是說所有服務(wù)使用一個端口，而是lagom使用算法，期間用到了項目名，也就是說，同一個項目。不管啥時候，它端口都是唯一的，算法導(dǎo)致的。
為每個服務(wù)分配一個端口的算法如下:
    >這個項目的名稱是散列的。
    >哈希絕對值被投影到端口范圍(默認的端口范圍是[49152,65535])
    >如果沒有其他項目聲明相同的端口，則指定的端口分配給項目。如果兩個或多個項目被投影到同一個端口上，相互沖突的項目是按字母順序排列的，首先出現(xiàn)的項目將得到分配給它的預(yù)期端口。然而，余下的項目將得到最接近的(嚴格的)可用的臨近的端口。
    總之，你不需要去擔心這個，與大多數(shù)情況一樣，端口范圍寬到足以使沖突不可能發(fā)生。然而，有時您可能仍然傾向于將特定的端口分配給服務(wù)(例如，如果自動分配的端口已經(jīng)在您的系統(tǒng)中使用）您可以手動為項目的服務(wù)端口設(shè)置提供端口號。
    在Maven中，您可以通過修改服務(wù)實現(xiàn)pom配置來實現(xiàn)這一點:
        
            com.lightbend.lagom
            lagom-maven-plugin
            
                11000
            
        
    上文中的算法的描述，在默認端口中，默認端口是[49152,65535]。這也稱為短暫的端口范圍，IANA為動態(tài)端口選擇使用了一系列的端口號。如果默認范圍不適合您，您可以通過在構(gòu)建中添加以下內(nèi)容來更改它。
    pom文件中加入：
        
            com.lightbend.lagom
            lagom-maven-plugin
            ${lagom.version}
            
                
                    40000
                    45000
                
            
        
    在此更改之后，您的服務(wù)項目將被分配到一個范圍[40000,45000]，但是需要注意的是，我們的端口范圍的小，帶來的是兩個服務(wù)碰巧是分配同一個端口的可能性就大了。這本身并不是問題(只要所有項目都有足夠的端口)，但是，在您的構(gòu)建中添加一個新的服務(wù)項目可能會導(dǎo)致對已分配到現(xiàn)有服務(wù)項目的端口的更改，如果這兩個項目都發(fā)生相同的端口。如果您不希望這種情況發(fā)生，請確保提供的端口范圍足夠?qū)挕；蛘撸謩訛榉?wù)項目分配端口，因為這是有意義的。
    

4.服務(wù)定位器（就類似于zk和eureka）

服務(wù)定位器嵌入在Lagom的開發(fā)環(huán)境中，允許服務(wù)發(fā)現(xiàn)并相互通信。有一些設(shè)置和任務(wù)可以為您喜歡的嵌入式服務(wù)定位器調(diào)整，讓我們來探索它們:
（1）默認的端口號
在Lagon中，服務(wù)發(fā)現(xiàn)的端口號默認的是8000,但是這個端口是非常容易被其他的應(yīng)用所占用的?；蛘?，您可以通過在構(gòu)建中添加以下內(nèi)容來告訴服務(wù)定位器在10000端口上運行。
在總項目下的pom文件里配置:
    
        com.lightbend.lagom
        lagom-maven-plugin
        ${lagom.version}
        
            10000
        
    
(2)與外部的服務(wù)進交互
可以在您的構(gòu)建中定義的Lagom服務(wù)和無限數(shù)量的外部服務(wù)(可以在本地運行或在另一臺機器上運行)之間進行通信。您要做的第一件事是在服務(wù)定位器中注冊每個外部服務(wù)。假設(shè)我們想要注冊一個名為weather的外部服務(wù)，它運行在http://localhost:3333中，下面是我們要添加到構(gòu)建的內(nèi)容。
在總項目下的pom文件里配置:
    
        com.lightbend.lagom
        lagom-maven-plugin
        ${lagom.version}
        
            
                http://localhost:3333
            
        
    
上面的內(nèi)容確保服務(wù)定位器知道天氣服務(wù)。然后，如果您需要一個Lagom服務(wù)來與它進行通信，只需將ServiceLocator進行@inject，并使用它來定位weather服務(wù)的URI，或者使用它執(zhí)行一些任意的工作。
（3）與外部的Lagom項目集成
請注意，如果您想要與之通信的服務(wù)實際上是一個Lagom服務(wù)，那么您可能想要閱讀有關(guān)與外部Lagom項目集成的文檔（就是Lagom參考指南（二）的第二節(jié)）。
（4）啟動與停止
當執(zhí)行runAll任務(wù)時，服務(wù)定位器會自動啟動。然而，有時您可能想手動啟動一些服務(wù)，因此您不會使用runAll任務(wù)。這種情況下，您可以通過maven命令行l(wèi)agon:startServiceLocator手動啟動服務(wù)定位器,或者是使用lagom:stopServiceLocator來停掉服務(wù)注冊中心。
（5）讓服務(wù)定位失效
您可以通過在構(gòu)建中添加以下內(nèi)容來禁用嵌入式服務(wù)定位器。
在maven項目根路徑下的pom文件：
    
        com.lightbend.lagom
        lagom-maven-plugin
        ${lagom.version}
        
            false
        
    
注意，通過禁用服務(wù)定位器，您的服務(wù)將無法進行通信。恢復(fù)通信,您必須在您的服務(wù)中提供ServiceLocator的實現(xiàn)。

5.Cassandra Server

默認情況下，需要保存數(shù)據(jù)的Lagom服務(wù)需要使用Cassandra作為數(shù)據(jù)庫。為了方便起見，我們在開發(fā)環(huán)境中嵌入了一個Cassandra服務(wù)器，這樣您就不必擔心安裝它了。針對您的個人需要，有一些設(shè)置和任務(wù)可用來調(diào)整Cassandra服務(wù)器，讓我們來探索它們:
（1）默認端口號
默認情況下，Cassandra服務(wù)器在端口4000上啟動。我們知道Cassandra 通常在端口9042上運行，這正是我們選擇不同端口的原因:如果你碰巧有一個的話，我們不想干擾本地運行的Cassandra 。如果當前的默認端口不適合您，例如您希望在端口9042上運行嵌入的Cassandra服務(wù)器，那么您可以通過在構(gòu)建中添加以下內(nèi)容來實現(xiàn)。
在meven的pom中配置：
    
        com.lightbend.lagom
        lagom-maven-plugin
        ${lagom.version}
        
            9042
        
    
 （2）啟動時候進行清理：
     默認情況下，運行服務(wù)創(chuàng)建的所有數(shù)據(jù)庫文件將在下一次啟動Cassandra服務(wù)器時刪除。您可以通過在構(gòu)建中添加以下內(nèi)容來關(guān)閉這個特性
    還是在maven的pom文件里：
        
            com.lightbend.lagom
            lagom-maven-plugin
            ${lagom.version}
            
            
                false
            
        
    （3）秘鑰空間（棄用）
    在Cassandra中的一個keyspace就代表一個名稱空間，它定義節(jié)點上的數(shù)據(jù)復(fù)制。每個服務(wù)應(yīng)該使用一個惟一的keyspace名稱，這樣不同服務(wù)的表就不會互相沖突。在開發(fā)環(huán)境中，默認情況下，keyspace將自動設(shè)置為項目的名稱(在可能替換了一些不允許的字符之后)。如果生成的密鑰空間不適合您，您可以提供自定義的密鑰空間。
    在Maven中，您可以通過修改服務(wù)實現(xiàn)的pom配置來做到這一點:
        
            com.lightbend.lagom
            lagom-maven-plugin
            
                true
                users
            
        
    值得指出的是，盡管上面有一個Cassandra密鑰空間，在運行您的服務(wù)時仍然需要提供。因此，如果您想提供可以在開發(fā)和生產(chǎn)中使用的Cassandra keyspace名稱，建議通過配置文件這樣做。
    例如：替代掉使用lagomCassandraKeyspace向我們之前那樣使用那樣來設(shè)置秘鑰空間，而我們可以通過在項目的application.conf中添加以下附加的鍵/值來獲得相同的結(jié)果（注意，如果沒有這個文件，那么你就得手動創(chuàng)建一個，放在/src/main/resources/中），內(nèi)容如下：
        cassandra-journal.keyspace=users
        cassandra-snapshot-store.keyspace=users
        lagom.persistence.read-side.cassandra.keyspace=users
    項目會使用我們在配置文件application.conf中配置的，而不是使用我們在pom中學的。因此，重寫構(gòu)建中的keyspace是不贊成的，并且將在后面的Lagom版本中刪除。
    有關(guān)配置keyspace的更多信息，請參見Cassandra持久實體配置（原文叫 Cassandra persistent entity configuration）。
（4）JVM選項
    Cassandra服務(wù)器在一個多帶帶的進程上運行，而JVM則是由合理的內(nèi)存默認啟動的。但是，如果默認的JVM選項不適合您，您可以通過在構(gòu)建中添加以下內(nèi)容來覆蓋它們。
    在maven父目錄的pom文件里寫：
        
            com.lightbend.lagom
            lagom-maven-plugin
            ${lagom.version}
            
                
                     -Xms256m
                     -Xmx1024m
                     -Dcassandra.jmx.local.port=4099
                     -DCassandraLauncher.configResource=dev-embedded-cassandra.yaml
                 
            
        
    （5）yaml 配置文件
    如上所示，可以通過修改Cassandra JVM選項來配置YAML配置文件，其中包括一個-DCassandraLauncher.configResource系統(tǒng)屬性的值來指向src/main/resource下的某個文件。
    （6）日志
    日志記錄是這樣配置的，它可以達到標準輸出，例如org.apache.cassandra設(shè)置為ERROR，下面是logback的設(shè)置。
        
        
          
            
              %date{ISO8601} %-5level %logger - %msg%n
            
          
                    
          
            
                       
        
       單數(shù)需要注意的是，內(nèi)嵌的Cassandra服務(wù)器是不允許你修改上面的這個配置文件。如果確實你想自定義自己的日志，那么只能自己安裝Cassandra服務(wù)器，并閱讀相關(guān)的配置介紹（就是下面的第10個小點）進行自定義。
   （7）Cassandra開始時間
       如前所述，runAll會在啟動其他服務(wù)之前啟動一個內(nèi)嵌的Cassandra服務(wù)器，而且服務(wù)通常只在Cassandra服務(wù)器可到達之后才開始。默認情況下，Cassandra服務(wù)器將在20秒內(nèi)啟動并運行，但是您可以通過在構(gòu)建中添加以下內(nèi)容來更改這個默認值。
       在maven的pon文件下：
       plugin>
            com.lightbend.lagom
            lagom-maven-plugin
            ${lagom.version}
            
                0
            
        
        設(shè)置Cassandra的最大啟動等待時間為0可以模擬真實的部署場景，因為運行的Cassandra實例可能無法在服務(wù)啟動時可用
    （8）關(guān)閉和啟動
        在執(zhí)行runAll任務(wù)時，將自動啟動Cassandra服務(wù)器。在執(zhí)行runAll任務(wù)時，將自動啟動Cassandra服務(wù)器。在這種情況下，你可以手動的啟動Cassandra 服務(wù)。如果是maven任務(wù)，你可以使用lagom:startCassandra來啟動Cassandra 任務(wù)，用lagom:stopCassandra 來關(guān)閉任務(wù)。
    （9）讓Cassandra  Disabled
        你可以通過添加如下的配置來讓內(nèi)嵌的Cassandra  失效。
        maven的pom文件里：
        
            com.lightbend.lagom
            lagom-maven-plugin
            ${lagom.version}
            
                false
            
        
        如果您需要您的服務(wù)連接到一個外部運行的、本地運行的Cassandra實例，那么上面的這些配置可以幫助你。
    （10）連接到本地運行的Cassandra實例
        可以連接到外部運行的Cassandra實例來代替嵌入的Cassandra實例。您所需要做的就是在構(gòu)建中添加以下內(nèi)容。
        maven的pom文件中：
        
            com.lightbend.lagom
            lagom-maven-plugin
            ${lagom.version}
            
                
                    http://localhost:9042
                
                false
            
        
        這兩個設(shè)置只能在運行Lagom的DevMode時使用。這兩個設(shè)置的目的是禁用嵌入式Cassandra服務(wù)器，并在DevMode中配置服務(wù)定位器，以便在尋找cas_native時仍然能夠找到Cassandra。如果您已經(jīng)有一個運行在本地或公司基礎(chǔ)設(shè)施中的Cassandra服務(wù)器，您可能想要禁用它。在這種情況下，Lagom啟動Cassandra服務(wù)器是沒有意義的，而且您還會獲得幾秒鐘的啟動時間。
        這些示例中的服務(wù)定位器設(shè)置假設(shè)您的本地Cassandra實例在端口9042上運行。
    

6.kafka服務(wù)器

默認情況下，Lagom服務(wù)需要使用Kafka作為消息代理與其他人之間共享信息的。在微服務(wù)體系結(jié)構(gòu)中，使用message broker對避免耦合服務(wù)過于強烈是至關(guān)重要的。因此，為了方便，我們在開發(fā)環(huán)境中嵌入了kafka服務(wù)器，這樣您就不必擔心安裝它了。有一些設(shè)置和任務(wù)可以調(diào)整kafka服務(wù)器，讓我們來探索它們:
（1）默認端口：
    默認情況下，kafka服務(wù)器默認的端口號是9092，kafka使用zk，因此一個zk服務(wù)器也在2181端口被啟動起來，如果當前的默認端口不適合您，您可以通過在構(gòu)建中添加以下內(nèi)容來更改
    在maven的pom文件下：
    
        com.lightbend.lagom
        lagom-maven-plugin
        ${lagom.version}
        
            10000
            9999
        
    
 （2）kafka properties文件
     kafka服務(wù)器可配置屬性文件。默認的，我們使用server.properties文件來為kafka提供配置，只有一個更改，允許在服務(wù)器上創(chuàng)建主題的自動創(chuàng)建。這是一個很好的默認快速啟動，但是如果你發(fā)現(xiàn)自己需要用不同的配置來啟動kafka，用下面的方式，你可以很容易的做到。
     maven的pom文件：
     
        com.lightbend.lagom
        lagom-maven-plugin
        ${lagom.version}
        
            ${basedir}/kafka-server.properties
        
    
（3）JVM優(yōu)化
    kafka服務(wù)器在一個多帶帶的進程上運行，并且JVM開始時具有合理的內(nèi)存默認值。但是，如果默認的JVM選項不適合您，您可以通過在構(gòu)建中添加以下內(nèi)容來覆蓋它們。
    
        com.lightbend.lagom
        lagom-maven-plugin
        ${lagom.version}
        
            
                 -Xms256m
                 -Xmx1024m
             
        
    
（4）日志
    將日志配置為只用于文件。您可以在文件夾中找到kafka的日志,文件目錄的格式為：
    /target/lagom-dynamic-projects/lagom-internal-meta-project-kafka/target/log4j_output
（5）Commit log
    kafka本質(zhì)上是一個持久的提交日志。您可以發(fā)現(xiàn)kafka在文件夾中保存的所有數(shù)據(jù)。
    /target/lagom-dynamic-projects/lagom-internal-meta-project-kafka/target/logs
（6）Start and stop
    kafka服務(wù)器在runAll命令的古時候是會自動啟動的。然而，有時你想手動的啟動幾個服務(wù)，不想手動runAlll，這種情況下，不可以通過命令來啟動kafka服務(wù)器，maven項目就是用lagom:startKafka，關(guān)閉的話就用lagom:stopKafka
（7）讓kafka失效
    您可以通過在構(gòu)建中添加以下內(nèi)容來禁用嵌入式Kafka服務(wù)器。
    
        com.lightbend.lagom
        lagom-maven-plugin
        ${lagom.version}
        
            false
        
    
    禁用嵌入式Kafka服務(wù)器的一個很好的理由是，如果您需要您的服務(wù)連接到一個外部的Kafka實例。
（8）連接到外部kafka服務(wù)器
    可以連接到外部的Kafka服務(wù)器來代替嵌入的服務(wù)器。您所需要做的就是在構(gòu)建中添加以下內(nèi)容。
    maven的pom文件：
    
        com.lightbend.lagom
        lagom-maven-plugin
        ${lagom.version}
        
            localhost:10000
            false
        
    
    您可能已經(jīng)注意到，上面配置的kafka服務(wù)器實際上在本地運行(請注意提供地址中的本地主機)。在這種情況下，它實際上已經(jīng)足夠配置正在運行的端口，而不必提供完整的地址。