Connect to an instance by using Session Manager CLI (ali-instance-cli) - Elastic Compute Service

Session Manager CLI nedir?

Session Manager CLI (ali-instance-cli), ECS örneklerine Session Manager aracılığıyla bağlanan bir Alibaba Cloud CLI aracıdır.

Komut satırı işlemleri için ali-instance-cli aracını Alibaba Cloud CLI ile birlikte de kullanabilirsiniz.

Ön koşullar

Session Manager hizmetini etkinleştirin

Konsolda Alibaba Cloud hesabınız için Session Manager hizmetini etkinleştirin:

ECS konsolu - Örnekler sayfasına gidin.
Üst gezinme çubuğunda, örnek için bölgeyi ve kaynak grubunu seçin.
Instance sayfasında, hedef örneği bulun ve Actions sütunundaki Connect öğesine tıklayın.
Show Other Logon Methods seçeneğine tıklayın. Session Manager seçeneğini bulun. Session Management closed yanındaki anahtarı açın. Ardından, hizmeti etkinleştirmek için ekrandaki talimatları izleyin.

Örneğin Çalışıyor durumunda olup olmadığını kontrol edin

Session Manager, örneğin Running durumunda olmasını gerektirir.

Console

ECS konsolundaki Instance sayfasında örnek durumunu görüntüleyin.

Ayrıntılar için bkz. Örnek bilgilerini görüntüleme .

Sol gezinme bölmesinde Instances & Images > Instances seçeneklerini belirleyin.

Örnek listesinde, SessionManager-example öğesinin durumunun Running olduğunu onaylayın.

Alibaba Cloud CLI

Alibaba Cloud CLI yapılandırılmışsa, örnek durumunu sorgulamak için aşağıdaki komutu çalıştırın. Parametre ayrıntıları için bkz. DescribeInstanceStatus.

Bu konuda örnek olarak Çin (Hangzhou) bölgesindeki i-bp1****** kimliğine sahip bir örnek kullanılmıştır.

aliyun ecs DescribeInstanceStatus --region cn-hangzhou --RegionId 'cn-hangzhou' --InstanceId.1 'i-bp1******'

Status değeri Running ise örnek çalışıyor demektir.

{
  "TotalCount": 1,
  "RequestId": "A413****-****-****-****-****611B",
  "PageSize": 1,
  "PageNumber": 1,
  "InstanceStatuses": {
    "InstanceStatus": [
      {
        "Status": "Running",
        "InstanceId": "i-bp1******"
      }
    ]
  }
}

Örnek durumunu sorgulamak için DescribeInstances API'sini de kullanabilirsiniz.

API

Bkz. DescribeInstanceStatus veya DescribeInstances.

Cloud Assistant Agent yüklü mü kontrol edin

Session Manager, Cloud Assistant gerektirir. Cloud Assistant Agent yazılımının örnekte yüklü olup olmadığını kontrol etmek için aşağıdaki yöntemlerden birini kullanın.

1 Aralık 2017 tarihinden sonra resmi genel görüntülerden oluşturulan ECS örneklerinde Cloud Assistant Agent ön yüklü olarak gelir . Bu tarihten önce oluşturulan veya özel karşıya yüklenen görüntülerden oluşturulan örnekler için Cloud Assistant Agent'ı yükleyin .

Console

Session Manager, Cloud Assistant'a bağlıdır. Örneğe Cloud Assistant Agent yükleyin ve ECS konsolundaki ECS Cloud Assistant sayfasında durumunu kontrol edin.

Cloud Assistant Agent , 1 Aralık 2017 tarihinden sonra Alibaba Cloud genel görüntülerinden oluşturulan ECS örneklerinde ön yüklü olarak gelir . Daha eski örnekler için Cloud Assistant Agent yazılımını manuel olarak yükleyin. Ayrıntılar için bkz. Cloud Assistant Agent'ı yükleme .

ECS konsolunun sol gezinme bölmesinde, O&M altında Cloud Assistant seçeneğine tıklayın.

Hedef örneğin Cloud Assistant Status sütununda Normal değerinin görüntülendiğini onaylayın.

Bkz. Cloud Assistant durumunu kontrol etme ve özel durumları giderme.

Alibaba Cloud CLI

Alibaba Cloud CLI yapılandırılmışsa, Cloud Assistant Agent kurulumunu ve Session Manager desteğini kontrol etmek için aşağıdaki komutu çalıştırın. Parametre ayrıntıları için bkz. DescribeCloudAssistantStatus.

Bu konuda örnek olarak Çin (Hangzhou) bölgesindeki i-bp1****** kimliğine sahip bir örnek kullanılmıştır.

aliyun ecs DescribeCloudAssistantStatus --region cn-hangzhou --RegionId 'cn-hangzhou' --InstanceId.1 'i-bp1******'

CloudAssistantStatus değeri true ve SupportSessionManager değeri true ise örnek Session Manager bağlantılarını destekler.

{
  "TotalCount": 1,
  "PageSize": 1,
  "RequestId": "DB34****-****-****-****-****A749",
  "NextToken": "",
  "PageNumber": 1,
  "InstanceCloudAssistantStatusSet": {
    "InstanceCloudAssistantStatus": [
      {
        "CloudAssistantVersion": "2.2.3.857",
        "SupportSessionManager": true,
        "InstanceId": "i-bp1******",
        "InvocationCount": 4,
        "OSType": "Linux",
        "CloudAssistantStatus": "true",
        "LastHeartbeatTime": "2024-12-10T02:38:04Z",
        "LastInvokedTime": "2024-12-08T16:02:45Z",
        "ActiveTaskCount": 0
      }
    ]
  }
}

API

Bkz. DescribeCloudAssistantStatus.

Session Manager için bir RAM kullanıcısının kimlik bilgilerini hazırlayın

ali-instance-cli kullanırken, RAM kullanıcısının AccessKey pair ve Security Token Service (STS) token bilgilerini belirtmeniz gerekir. Bir örneğe Session Manager kullanarak bağlandığınızda sistem, kimlik bilgilerine sahip RAM kullanıcısının ecs:StartTerminalSession iznine sahip olup olmadığını doğrular.

Özel bir ilke yapılandırırken, bir RAM kullanıcısının Session Manager kullanarak bağlanabileceği ECS örneklerini belirtmek üzere Resource parametresini yapılandırabilirsiniz. Örnek ilke:

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "ecs:StartTerminalSession",
      "Resource": "*"
    }
  ]
}

CredentialsURI ve STS Token parametreleri hakkında bilgi için bkz. AccessKey çifti oluşturma ve STS'ye genel bakış

Bir RAM kullanıcısına izin verme hakkında bilgi için bkz. RAM kullanıcı izinlerini yönetme.

1. Session Manager CLI'yı yükleyin ve yapılandırın

Not

Session Manager CLI'yı zaten yüklediyseniz ve yapılandırdıysanız bu adımı atlayın.

1.1 Yükleme

Session Manager CLI'yı (ali-instance-cli) bilgisayarınıza yükleyin. Yükleme yöntemi işletim sistemine göre değişir.

Windows

Windows için ali-instance-cli dosyasını indirmek için tıklayın ve yerel bir klasöre kaydedin.

Bu konuda örnek olarak C:\Users\test klasörü kullanılmıştır.

macOS

macOS terminalinde, macOS için ali-instance-cli dosyasını indirin:

curl -O https://aliyun-client-assist.oss-accelerate.aliyuncs.com/session-manager/mac/ali-instance-cli

Çalıştırma izinleri verin:

chmod a+x ali-instance-cli

Linux

Linux için ali-instance-cli yükleyin:

x86 architecture

curl -O https://aliyun-client-assist.oss-accelerate.aliyuncs.com/session-manager/linux/ali-instance-cli

arm architecture

curl -O https://aliyun-client-assist.oss-cn-beijing.aliyuncs.com/session-manager/linux_arm/ali-instance-cli

Çalıştırma izinleri verin:

chmod a+x ali-instance-cli

1.2 Yapılandırma

Bir ECS örneğine ali-instance-cli ile bağlanmak için AccessKey gibi kimlik bilgilerini yapılandırın. Bkz. Session Manager için bir RAM kullanıcısının kimlik bilgilerini hazırlayın.

Windows

Start > Run seçeneğine tıklayın, cmd girin ve komut istemi penceresini açmak için Enter tuşuna basın.
ali-instance-cli.exe dizinine gidin. Bu örnekte C:\Users\test kullanılmaktadır.
```
cd C:\Users\test
```
Kimlik bilgilerini aşağıdaki yöntemlerden birini kullanarak yapılandırın:
AccessKey

İstendiğinde AccessKey ID, AccessKey secret ve Region ID değerlerini yapılandırın:
```
ali-instance-cli.exe configure --mode AK
```
STS Token

Yapılandırmayı tamamlayın:
```
ali-instance-cli.exe configure set --mode StsToken --region "<region>" --access-key-id "<ak>"  --access-key-secret "<sk>"   --sts-token "<sts_token>"
```
<region>, <ak>, <sk> ve <sts_token> değerlerini gerçek bölge kimliğiniz, AccessKey Kimliğiniz, AccessKey Gizli Anahtarınız ve STS token ile değiştirin.
CredentialsURI

İstendiğinde Credentials URI ve Region ID değerlerini girin:
```
ali-instance-cli.exe configure --mode=CredentialsURI
```
Aşağıdaki çıktı, yapılandırmanın başarılı olduğunu gösterir.

macOS/Linux

ali-instance-cli dizinine gidin. Bu örnekte ev dizini ~ kullanılmaktadır.
```
cd ~
```
Kimlik bilgilerini yapılandırın:
AccessKey

İstendiğinde AccessKey ID, AccessKey secret ve Region ID değerlerini yapılandırın:
```
./ali-instance-cli configure --mode AK
```
STS Token

Yapılandırmayı tamamlayın:
```
./ali-instance-cli configure set --mode StsToken --region "<region>" --access-key-id "<ak>"  --access-key-secret "<sk>"   --sts-token "<sts_token>"
```
<region>, <ak>, <sk> ve <sts_token> değerlerini gerçek bölge kimliğiniz, AccessKey Kimliğiniz, AccessKey Gizli Anahtarınız ve STS token ile değiştirin.
CredentialsURI

İstendiğinde Credentials URI ve Region ID değerlerini yapılandırın:
```
./ali-instance-cli configure --mode=CredentialsURI
```
Aşağıdaki çıktı, yapılandırmanın başarılı olduğunu gösterir.

2. Session Manager kullanarak bir örneğe bağlanma

2.1 Örnek kimliğini alma

Session Manager ile bağlanmadan önce örnek kimliğini alın.

Console

Go to ECS console - Instances.
In the top navigation bar, select the region and resource group for the instance.
On the Instance page, find the instance that you want to connect to. The instance ID is shown in the figure.

Alibaba Cloud CLI

Alibaba Cloud CLI yapılandırılmışsa, örnek kimliğini almak için aşağıdaki komutu çalıştırın. Parametre ayrıntıları için bkz. DescribeInstances.

Bu konuda örnek olarak Çin (Hangzhou) bölgesindeki SessionManager-example adlı bir örnek kullanılmıştır.

aliyun ecs DescribeInstances --region cn-hangzhou --RegionId 'cn-hangzhou' --InstanceName 'SessionManager-example'

Yanıtta döndürülen InstanceId değeri örnek kimliğidir.

API

Bkz. DescribeInstances.

2.2 ali-instance-cli Session Manager özelliğini kullanma

Local machine: Windows

Komut isteminde, ali-instance-cli.exe dizinine gidin ve örneğe bağlanın. <instance_id> yerine Adım 2.1'deki örnek kimliğini yazın.

ali-instance-cli.exe session --instance <instance_id>

Örnek: i-bp1****** kimliğine sahip bir örneğe bağlanma:

ali-instance-cli.exe session --instance i-bp1******

Bağlantı başarılı olduktan sonra örneğin komut satırı arayüzüne erişebilirsiniz.

macOS/Linux

Terminalde, ali-instance-cli dizinine gidin ve örneğe bağlanın. <instance_id> yerine Adım 2.1'deki örnek kimliğini yazın.

./ali-instance-cli session --instance <instance_id>

Örnek: i-bp1****** kimliğine sahip bir örneğe bağlanma:

./ali-instance-cli session --instance i-bp1******

Aşağıdaki çıktı, bağlantının başarılı olduğunu gösterir. Artık örneğin komut satırı arayüzüne erişebilirsiniz.

2.3 ali-instance-cli kullanarak bir LINGJUN düğümüne bağlanma

1.x.0.93 sürümünden başlayarak, ali-instance-cli alt komutu session, --node parametresini destekler. Bağlanılacak LINGJUN düğümünün kimliğini belirtmek için bu parametreyi kullanın.

Local machine: Windows

Komut isteminde, ali-instance-cli.exe dizinine gidin ve aşağıdaki komutu çalıştırın. <lingjun_node_id> yerine LINGJUN düğümünün kimliğini yazın.

ali-instance-cli.exe session --node <lingjun_node_id>

Bağlantı başarılı olduktan sonra LINGJUN düğümünün komut satırı arayüzüne erişebilirsiniz.

macOS/Linux

Terminalde, ali-instance-cli dizinine gidin ve aşağıdaki komutu çalıştırın. <lingjun_node_id> yerine LINGJUN düğümünün kimliğini yazın.

./ali-instance-cli session --node <lingjun_node_id>

Bağlantı başarılı olduktan sonra LINGJUN düğümünün komut satırı arayüzüne erişebilirsiniz.

Diğer özellikler

Session Manager CLI (ali-instance-cli) aşağıdaki özellikleri de destekler:

Genel IP adresi olmayan örneklere erişim (bağlantı noktası iletme)

Proxy veya atlama sunucularını atlayarak, genel IP adresi olmayan örneklerdeki hizmetlere erişmek için bir örnek bağlantı noktasını yerel bir bağlantı noktasına eşleyin.
Geçici SSH genel anahtarlarını kaydetme

Hedef örnekle geçici bir genel anahtar kaydedin ve SSH bağlantıları için ilgili özel anahtarı kullanın.

SSS

Bir komut çalıştırdıktan sonra komut satırı yanıt vermiyor (Örnek Çalışıyor durumunda değil)

Bir ali-instance-cli komutu çalıştırdıktan sonra komut satırı yanıt vermiyorsa örnek Running durumunda olmayabilir. Örnek durumunu görüntülemek için bu konudaki Örneğin Çalışıyor durumunda olup olmadığını kontrol edin bölümüne bakın.

Bir komut çalıştırdıktan sonra komut satırı yanıt vermiyor (Güvenlik grubu yapılandırma sorunu)

Bir ali-instance-cli komutu çalıştırdıktan sonra komut satırı yanıt vermiyorsa güvenlik grubunda gerekli giden bağlantı noktaları açık olmayabilir. Varsayılan olarak temel güvenlik grupları tüm giden trafiğe izin verir. Giden kurallarını değiştirdiyseniz veya gelişmiş bir güvenlik grubu kullanıyorsanız bu sorun oluşabilir.

Session Manager kullanarak bir ECS örneğine bağlanırken, aşağıdaki kuralları bir giden güvenlik grubuna ekleyerek ECS örneğinde çalışan Cloud Assistant Agent yazılımının Cloud Assistant sunucusuna bağlı olduğundan emin olun:

SSH ve Uzak Masaüstü Protokolü (RDP) gibi diğer bağlantı yöntemleriyle karşılaştırıldığında Cloud Assistant Agent , Session Manager sunucusuna aktif olarak bir WebSocket bağlantısı kurar. Bir güvenlik kuralında Cloud Assistant sunucusunun giden WebSocket bağlantı noktasını açmanız yeterlidir. Session Manager'ın çalışma şekli hakkında bilgi için bu konunun Session Manager nasıl çalışır? bölümüne bakın.

Önemli

Varsayılan güvenlik grubu dahil olmak üzere temel güvenlik grupları kullanıyorsanız tüm giden trafiğe izin verilir. Ek yapılandırma gerekmez.
Gelişmiş bir güvenlik grubu kullanıyorsanız tüm giden trafik reddedilir. İlgili kuralları yapılandırmanız gerekir. Kurallar aşağıdaki tabloda açıklanmıştır. Güvenlik grupları hakkında bilgi için bkz. Temel ve gelişmiş güvenlik grupları.

Bir güvenlik grubuna kural ekleme hakkında bilgi için bkz. Güvenlik grubu kuralı ekleme.

Action	Priority	Protocol type	Port range	Authorization object	Description
Allow	1	Custom TCP	443	`100.100.0.0/16`	Bu bağlantı noktası, Cloud Assistant sunucusuna erişmek için kullanılır.
Allow	1	Custom TCP	443	`100.0.0.0/8`	Bu bağlantı noktası, Cloud Assistant Agent yüklemek veya güncellemek istediğinizde Cloud Assistant Agent yükleme paketinin depolandığı sunucuya erişmek için kullanılır.
Allow	1	Custom UDP	53	`0.0.0.0/0`	Bu bağlantı noktası, alan adlarını çözümlemek için kullanılır.

Bir örneğe yalnızca Session Manager kullanarak bağlanmak istiyorsanız, ECS örneğinin güvenliğini artırmak amacıyla bir güvenlik grubundan SSH bağlantı noktasına (varsayılan 22) ve RDP bağlantı noktasına (varsayılan 3389) izin veren gelen kurallarını silin.

Bir komut çalıştırdıktan sonra DeliveryTimeout hatası bildiriliyor (Cloud Assistant Agent çevrimdışı)

Bir ali-instance-cli komutu çalıştırdığınızda DeliveryTimeout hatası oluşursa Cloud Assistant Agent kullanılamıyor olabilir. Cloud Assistant Agent'ın örnekte yüklü olup olmadığını kontrol edin.

Bir komut çalıştırdıktan sonra "session manager is disabled, please enable first" hatası bildiriliyor

Bir ali-instance-cli komutu çalıştırdıktan sonra session manager is disabled, please enable first hatası oluşursa konsolda Session Manager'ı etkinleştirin.

Uzun süreli hareketsizlik nedeniyle bağlantı otomatik olarak kapatılıyor

Session Manager bağlantıları, boşta kalma zaman aşımından sonra kapanır. Varsayılan süre 3 dakikadır. Saniye cinsinden özel bir boşta kalma zaman aşımı ayarlamak için --idle-timeout parametresini kullanın.

Örnek: 10 dakikalık boşta kalma zaman aşımı ile bağlanma:

./ali-instance-cli session --instance instance-id --idle-timeout 600

Not

Bu özellik için ali-instance-cli sürümü gereklidir:

Linux: 1.2.0.48
Windows: 1.1.0.48
macOS: 1.3.0.48

ali-instance-cli günlükleri nasıl analiz edilir

Sorunları belirlemek için ali-instance-cli günlüklerini analiz edin.

Session Manager CLI günlükleri: ali-instance-cli kullanırken, aracın dizininde bir günlük klasörü (ör. ~/log/aliyun_ecs_session_log.2022XXXX) oluşturulur.

Cloud Assistant Agent günlükleri:

Linux

/usr/local/share/aliyun-assist/<Cloud Assistant Agent version>/log/

Windows

C:\ProgramData\aliyun\assist\<Cloud Assistant Agent version>\log

Session Manager CLI nedir?

Ön koşullar

Session Manager hizmetini etkinleştirin

Örneğin Çalışıyor durumunda olup olmadığını kontrol edin

Console

Alibaba Cloud CLI

API

**Cloud Assistant Agent** yüklü mü kontrol edin

Console

Alibaba Cloud CLI

API

Session Manager için bir RAM kullanıcısının kimlik bilgilerini hazırlayın

1. Session Manager CLI'yı yükleyin ve yapılandırın

1.1 Yükleme

Windows

macOS

Linux

x86 architecture

arm architecture

1.2 Yapılandırma

Windows

AccessKey

STS Token

CredentialsURI

macOS/Linux

AccessKey

STS Token

CredentialsURI

2. Session Manager kullanarak bir örneğe bağlanma

2.1 Örnek kimliğini alma

Console

Alibaba Cloud CLI

API

2.2 ali-instance-cli Session Manager özelliğini kullanma

Local machine: Windows

macOS/Linux

2.3 ali-instance-cli kullanarak bir LINGJUN düğümüne bağlanma

Local machine: Windows

macOS/Linux

Diğer özellikler

SSS

Bir komut çalıştırdıktan sonra komut satırı yanıt vermiyor (Örnek Çalışıyor durumunda değil)

Bir komut çalıştırdıktan sonra komut satırı yanıt vermiyor (Güvenlik grubu yapılandırma sorunu)

Bir komut çalıştırdıktan sonra DeliveryTimeout hatası bildiriliyor (Cloud Assistant Agent çevrimdışı)

Bir komut çalıştırdıktan sonra "session manager is disabled, please enable first" hatası bildiriliyor

Uzun süreli hareketsizlik nedeniyle bağlantı otomatik olarak kapatılıyor

ali-instance-cli günlükleri nasıl analiz edilir

Cloud Assistant Agent yüklü mü kontrol edin