AWS CodeStar 예제 사용 AWS CLI

다음 코드 예제는 with 를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다 AWS CodeStar. AWS Command Line Interface

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예제에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 상황에 맞게 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.

작업

associate-team-member

다음 코드 예시에서는 associate-team-member을 사용하는 방법을 보여 줍니다.

AWS CLI

프로젝트에 팀원 추가하기

다음 associate-team-member 예제에서는 intern 사용자를 지정된 ID의 프로젝트 뷰어로 만듭니다.

aws codestar associate-team-member \
    --project-id my-project \
    --user-arn arn:aws:iam::123456789012:user/intern \
    --project-role Viewer

이 명령은 출력을 생성하지 않습니다.

• 자세한 API 내용은 AWS CLI 명령 AssociateTeamMember참조를 참조하십시오.

create-project

다음 코드 예시에서는 create-project을 사용하는 방법을 보여 줍니다.

AWS CLI

프로젝트를 만들려면

다음 create-project 예제에서는 JSON 입력 파일을 사용하여 CodeStar 프로젝트를 생성합니다.

aws codestar create-project \
    --cli-input-json file://create-project.json

create-project.json의 콘텐츠:

{
    "name": "Custom Project",
    "id": "custom-project",
    "sourceCode": [
        {
            "source": {
                "s3": {
                    "bucketName": "codestar-artifacts",
                    "bucketKey": "nodejs-function.zip"
                }
            },
            "destination": {
                "codeCommit": {
                    "name": "codestar-custom-project"
                }
            }
        }
    ],
    "toolchain": {
        "source": {
            "s3": {
                "bucketName": "codestar-artifacts",
                "bucketKey": "toolchain.yml"
            }
        },
        "roleArn": "arn:aws:iam::123456789012:role/service-role/aws-codestar-service-role",
        "stackParameters": {
            "ProjectId": "custom-project"
        }
    }
}

출력:

{
    "id": "my-project",
    "arn": "arn:aws:codestar:us-east-2:123456789012:project/custom-project"
}

사용자 정의 프로젝트용 샘플 코드와 템플릿이 포함된 자습서는 사용 안내서의 AWS CLI < https://docs.aws.amazon.com/codestar/ latest/userguide/cli-tutorial.html>을 사용하여 프로젝트 만들기를 참조하십시오. AWS CodeStar AWS CodeStar

• 자세한 API 내용은 명령 참조서를 참조하십시오. CreateProjectAWS CLI

create-user-profile

다음 코드 예시에서는 create-user-profile을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자 프로필을 만들려면

다음 create-user-profile 예제에서는 지정된 프로필을 사용하여 IAM 사용자의 사용자 프로필을 생성합니다ARN.

aws codestar create-user-profile \
    --user-arn arn:aws:iam::123456789012:user/intern \
    --display-name Intern \
    --email-address [e-mail]

출력:

{
    "userArn": "arn:aws:iam::123456789012:user/intern",
    "displayName": "Intern",
    "emailAddress": "[e-mail]",
    "sshPublicKey": "",
    "createdTimestamp": 1572552308.607,
    "lastModifiedTimestamp": 1572552308.607
}

• 자세한 API 내용은 AWS CLI 명령 CreateUserProfile참조를 참조하십시오.

delete-project

다음 코드 예시에서는 delete-project을 사용하는 방법을 보여 줍니다.

AWS CLI

프로젝트를 삭제하려면

다음 delete-project 예제에서는 지정된 프로젝트를 삭제합니다.

aws codestar delete-project \
    --project-id my-project

출력:

{
    "projectArn": "arn:aws:codestar:us-east-2:123456789012:project/my-project"
}

• 자세한 API 내용은 AWS CLI 명령 DeleteProject참조를 참조하십시오.

delete-user-profile

다음 코드 예시에서는 delete-user-profile을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자 프로필을 삭제하려면

다음 delete-user-profile 예제에서는 지정된 ARN 사용자의 사용자 프로필을 삭제합니다.

aws codestar delete-user-profile \
    --user-arn arn:aws:iam::123456789012:user/intern

출력:

{
    "userArn": "arn:aws:iam::123456789012:user/intern"
}

• 자세한 API 내용은 AWS CLI 명령 DeleteUserProfile참조를 참조하십시오.

describe-project

다음 코드 예시에서는 describe-project을 사용하는 방법을 보여 줍니다.

AWS CLI

프로젝트를 보려면

다음 describe-project 예제는 지정된 프로젝트에 대한 세부 정보를 검색합니다.

aws codestar describe-project \
    --id my-project

출력:

{
    "name": "my project",
    "id": "my-project",
    "arn": "arn:aws:codestar:us-west-2:123456789012:project/my-project",
    "description": "My first CodeStar project.",
    "createdTimeStamp": 1572547510.128,
    "status": {
        "state": "CreateComplete"
    }
}

• 자세한 API 내용은 AWS CLI 명령 DescribeProject참조를 참조하십시오.

describe-user-profile

다음 코드 예시에서는 describe-user-profile을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자 프로필을 보려면

다음 describe-user-profile 예에서는 지정된 ARN 사용자 프로필의 사용자 프로필에 대한 세부 정보를 검색합니다.

aws codestar describe-user-profile \
    --user-arn arn:aws:iam::123456789012:user/intern

출력:

{
    "userArn": "arn:aws:iam::123456789012:user/intern",
    "displayName": "Intern",
    "emailAddress": "[e-mail]",
    "sshPublicKey": "intern",
    "createdTimestamp": 1572552308.607,
    "lastModifiedTimestamp": 1572553495.47
}

• 자세한 API 내용은 AWS CLI 명령 DescribeUserProfile참조를 참조하십시오.

disassociate-team-member

다음 코드 예시에서는 disassociate-team-member을 사용하는 방법을 보여 줍니다.

AWS CLI

팀원 제거하기

다음 disassociate-team-member 예제에서는 지정된 ARN 권한을 가진 사용자를 프로젝트에서 제거합니다my-project.

aws codestar disassociate-team-member \
    --project-id my-project \
    --user-arn arn:aws:iam::123456789012:user/intern

이 명령은 출력을 생성하지 않습니다.

• 자세한 API 내용은 AWS CLI 명령 DisassociateTeamMember참조를 참조하십시오.

list-projects

다음 코드 예시에서는 list-projects을 사용하는 방법을 보여 줍니다.

AWS CLI

프로젝트를 보려면

다음 list-projects 예제는 현재 지역의 프로젝트 목록을 가져옵니다.

aws codestar list-projects

출력:

{
    "projects": [
        {
            "projectId": "intern-projects",
            "projectArn": "arn:aws:codestar:us-west-2:123456789012:project/intern-projects"
        },
        {
            "projectId": "my-project",
            "projectArn": "arn:aws:codestar:us-west-2:123456789012:project/my-project"
        }
    ]
}

• 자세한 API 내용은 AWS CLI 명령 ListProjects참조를 참조하십시오.

list-resources

다음 코드 예시에서는 list-resources을 사용하는 방법을 보여 줍니다.

AWS CLI

리소스를 보려면

다음 list-resources 예제는 지정된 프로젝트의 리소스 목록을 검색합니다.

aws codestar list-resources \
    --id my-project

출력:

{
    "resources": [
        {
            "id": "arn:aws:execute-api:us-east-2:123456789012:r3wxmplbv8"
        },
        {
            "id": "arn:aws:codedeploy:us-east-2:123456789012:application:awscodestar-my-project-lambda-ServerlessDeploymentApplication-PF0LXMPL1KA0"
        },
        {
            "id": "arn:aws:s3:::aws-codestar-us-east-2-123456789012-my-project-pipe"
        },
        {
            "id": "arn:aws:lambda:us-east-2:123456789012:function:awscodestar-my-project-lambda-GetHelloWorld-16W3LVXMPLNNS"
        },
        {
            "id": "arn:aws:cloudformation:us-east-2:123456789012:stack/awscodestar-my-project-lambda/b4904ea0-fc20-xmpl-bec6-029123b1cc42"
        },
        {
            "id": "arn:aws:cloudformation:us-east-2:123456789012:stack/awscodestar-my-project/1b133f30-fc20-xmpl-a93a-0688c4290cb8"
        },
        {
            "id": "arn:aws:iam::123456789012:role/CodeStarWorker-my-project-ToolChain"
        },
        {
            "id": "arn:aws:iam::123456789012:policy/CodeStar_my-project_PermissionsBoundary"
        },
        {
            "id": "arn:aws:s3:::aws-codestar-us-east-2-123456789012-my-project-app"
        },
        {
            "id": "arn:aws:codepipeline:us-east-2:123456789012:my-project-Pipeline"
        },
        {
            "id": "arn:aws:codedeploy:us-east-2:123456789012:deploymentgroup:my-project/awscodestar-my-project-lambda-GetHelloWorldDeploymentGroup-P7YWXMPLT0QB"
        },
        {
            "id": "arn:aws:iam::123456789012:role/CodeStar-my-project-Execution"
        },
        {
            "id": "arn:aws:iam::123456789012:role/CodeStarWorker-my-project-CodeDeploy"
        },
        {
            "id": "arn:aws:codebuild:us-east-2:123456789012:project/my-project"
        },
        {
            "id": "arn:aws:iam::123456789012:role/CodeStarWorker-my-project-CloudFormation"
        },
        {
            "id": "arn:aws:codecommit:us-east-2:123456789012:Go-project"
        }
    ]
}

• 자세한 API 내용은 AWS CLI 명령 ListResources참조를 참조하십시오.

list-tags-for-project

다음 코드 예시에서는 list-tags-for-project을 사용하는 방법을 보여 줍니다.

AWS CLI

프로젝트의 태그를 보려면

다음 list-tags-for-project 예제는 지정된 프로젝트에 첨부된 태그를 검색합니다.

aws codestar list-tags-for-project \
    --id my-project

출력:

{
    "tags": {
        "Department": "Marketing",
        "Team": "Website"
    }
}

• 자세한 API 내용은 AWS CLI 명령 ListTagsForProject참조를 참조하십시오.

list-team-members

다음 코드 예시에서는 list-team-members을 사용하는 방법을 보여 줍니다.

AWS CLI

팀 구성원 목록을 보려면

다음 list-team-members 예제는 지정된 프로젝트와 관련된 사용자 목록을 검색합니다.

aws codestar list-team-members \
    --project-id my-project

출력:

{
    "teamMembers": [
        {
            "userArn": "arn:aws:iam::123456789012:user/admin",
            "projectRole": "Owner",
            "remoteAccessAllowed": false
        },
        {
            "userArn": "arn:aws:iam::123456789012:user/intern",
            "projectRole": "Contributor",
            "remoteAccessAllowed": false
        }
    ]
}

• 자세한 API 내용은 AWS CLI 명령 ListTeamMembers참조를 참조하십시오.

list-user-profiles

다음 코드 예시에서는 list-user-profiles을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자 프로필 목록을 보려면

다음 list-user-profiles 예제는 현재 지역의 모든 사용자 프로필 목록을 검색합니다.

aws codestar list-user-profiles

출력:

{
    "userProfiles": [
        {
            "userArn": "arn:aws:iam::123456789012:user/admin",
            "displayName": "me",
            "emailAddress": "[e-mail]",
            "sshPublicKey": ""
        },
        {
            "userArn": "arn:aws:iam::123456789012:user/intern",
            "displayName": "Intern",
            "emailAddress": "[e-mail]",
            "sshPublicKey": "intern"
        }
    ]
}

• 자세한 API 내용은 AWS CLI 명령 ListUserProfiles참조를 참조하십시오.

tag-project

다음 코드 예시에서는 tag-project을 사용하는 방법을 보여 줍니다.

AWS CLI

프로젝트에 태그 첨부하기

다음 tag-project 예제에서는 지정된 프로젝트에 이름이 Department 지정된 태그와 값을 추가합니다. Marketing

aws codestar tag-project \
    --id my-project \
    --tags Department=Marketing

출력:

{
    "tags": {
        "Department": "Marketing"
    }
}

• 자세한 API 내용은 AWS CLI 명령 TagProject참조를 참조하십시오.

untag-project

다음 코드 예시에서는 untag-project을 사용하는 방법을 보여 줍니다.

AWS CLI

프로젝트에서 태그 삭제하기

다음 untag-project 예제는 지정된 프로젝트에서 키 이름이 1인 Team 태그를 모두 제거합니다.

aws codestar untag-project \
    --id my-project \
    --tags Team

이 명령은 출력을 생성하지 않습니다.

• 자세한 API 내용은 AWS CLI 명령 UntagProject참조를 참조하십시오.

update-project

다음 코드 예시에서는 update-project을 사용하는 방법을 보여 줍니다.

AWS CLI

프로젝트를 업데이트하려면

다음 update-project 예제에서는 지정된 프로젝트에 설명을 추가합니다.

aws codestar update-project \
    --id my-project \
    --description "My first CodeStar project"

이 명령은 출력을 생성하지 않습니다.

• 자세한 API 내용은 AWS CLI 명령 UpdateProject참조를 참조하십시오.

update-team-member

다음 코드 예시에서는 update-team-member을 사용하는 방법을 보여 줍니다.

AWS CLI

팀원을 수정하려면

다음 update-team-member 예제에서는 지정된 사용자를 프로젝트 기여자로 만들고 프로젝트 리소스에 대한 원격 액세스 권한을 부여합니다.

aws codestar update-team-member \
    --project-id my-project \
    --user-arn arn:aws:iam::123456789012:user/intern \
    --project-role Contributor -\
    --remote-access-allowed

출력:

{
    "userArn": "arn:aws:iam::123456789012:user/intern",
    "projectRole": "Contributor",
    "remoteAccessAllowed": true
}

• 자세한 API 내용은 AWS CLI 명령 UpdateTeamMember참조를 참조하십시오.

update-user-profile

다음 코드 예시에서는 update-user-profile을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자 프로필을 수정하려면

다음 update-user-profile 예제는 지정된 사용자에게 지정된 SHH 키를 추가합니다.

aws codestar update-user-profile \
    --ssh-public-key intern \
    --user-arn arn:aws:iam::123456789012:user/intern

출력:

{
    "userArn": "arn:aws:iam::123456789012:user/intern",
    "displayName": "Intern",
    "emailAddress": "[e-mail]",
    "sshPublicKey": "intern",
    "createdTimestamp": 1572552308.607,
    "lastModifiedTimestamp": 1572553495.47
}

• 자세한 API 내용은 AWS CLI 명령 UpdateUserProfile참조를 참조하십시오.