Kuidas kasutada HashiCorp Waypoint'i GitLab CI/CD-ga koostööks

HashiCorp tutvustas uut projekti Waypoint . Tundub, et HashiCorp Digital. See kasutab HCL-põhist faili, et kirjeldada rakenduste koostamist, tarnimist ja väljalaset erinevatele pilveplatvormidele alates Kubernetesest kuni AWS ja Google Cloud Runini. Waypointit võib pidada Terraformi ja Vagrandi koosmõjuks, et kirjeldada teie rakenduste koostamise, tarnimise ja väljalaske protsessi.

Ilma enda olemust muutmata on HashiCorp välja andnud avatud lähtekoodiga Waypoint'i, millele on lisatud arvukalt näiteid. Orkestreerimise tase jääb teie otsustada; Waypoint on saadaval käivitatava failina, mida saad käivitada otse oma sülearvutist või valitud CI/CD orkestreerimise tööriistast. Rakenduste juurutamise sihtkoht valitakse samuti teie poolt, kuna Waypoint toetab Kubernetes, Docker, Google Cloud Run, AWS ECS ja teisi.

Pärast huvitavate dokumentatsioon ja elegantselt näidiste rakendustest, mille on pakkunud HashiCorp, otsustasime uurida Waypoint'i orkestreerimist GitLab CI/CD kaudu. Selleks võtame lihtsa Node.js rakenduse, mis töötab AWS ECS-is, näidiste hoidlast.

Pärast hoidla kloonimist vaatame rakenduse struktuuri, mis kuvab ühte lehte:

Nagu olete võib-olla märganud, ei ole selles projektis Dockerfile'i. Need ei ole näidisesse lisatud, kuna nad pole meile tegelikult vajalikud, sest Waypoint hoolitseb nende eest meie nimel. Vaatame lähemalt faili waypoint.hcl, et mõista, mida see teeb:

project = "example-nodejs"

app "example-nodejs" {
  labels = {
    "service" = "example-nodejs",
    "env" = "dev"
  }

  build {
    use "pack" {}
    registry {
    use "aws-ecr" {
        region = "us-east-1"
        repository = "waypoint-gitlab"
        tag = "latest"
    }
    }
  }

  deploy {
    use "aws-ecs" {
    region = "us-east-1"
    memory = "512"
    }
  }
}

Koostamise etapis kasutab Waypoint Cloud Native Buildpacke (CNB), et määrata projekti programmeerimiskeel ja luua Docker'i pilt ilma Dockerfile'i kasutamata. Tegelikult on see sama tehnoloogia, mida GitLab kasutab Auto DevOps osa Auto Build'i sammus. Tore näha, et CNB CNCF-ist saab üha rohkem kasutust tööstuses.

Kui pilt on loodud, laadib Waypoint selle automaatselt meie AWS ECR registrisse, et see oleks tarnimiseks valmis. Koostamise lõppedes kasutab tarnimise etapp AWS ECS laiendust , et juurutada meie rakendust meie AWS kontole.

Minu sülearvutist on kõik lihtne. Installin Waypoint'i, mis on juba minu AWS kontoga autentitud, ja see "lihtsalt töötab". Aga mis siis, kui ma tahan minna kaugemale oma sülearvutist? Või äkki tahan automatiseerida seda juurutamist osana mu üldisest CI/CD torustikust, kus jooksevad mu hetke integratsiooni testid, turvatestid ja muud? See on see osa jutust, kus tuleb mängu GitLab CI/CD!

Märkus. Kui te alles plaanite CI/CD rakendamist või soovite alustada parimate praktikate rakendamisega torustike loomisel, pöörake tähelepanu uuele Slõerma kursusele "CI/CD GitLab CI näitel". See on praegu saadaval eeltellimise hinnaga.

Waypoint GitLab CI/CD-s

Selleks, et kõike seda orkestreerida GitLab CI/CD-s, vaatame, mida meil meie failis vaja läheb. .gitlab-ci.yml:

• Esiteks, vajame põhi pilti, mille sees seda käivitada. Waypoint töötab igasugustel Linuxi distributsioonidel, selleks on ainult vajalik Docker, seega saame käivituda generiiliselt Docker'i pildilt.
• Seejärel tuleb see pilt Waypoint'iga varustada. Tulevikus saame koguda meta build pildi ja konteineriseerida selle protsessi enda jaoks.
• Lõpuks käivitame Waypoint'i käsud.

Ülalpool on kirjeldatud kõik, mida meie torustik vajab juurutamiseks vajalike skriptide käivitamiseks, kuid AWS-sse juurutamiseks vajame veel ühte asja: peame meie AWS kontosse autentima. Waypoint'i kirjelduses on plaanid autentimise ja autoriseerimise kohta. HashiCorp esitles sel nädalal ka muljetavaldavat projekti Boundary. Kuid hetkel saame lihtsalt autentimise ja autoriseerimise ise ära teha.

AWS autentimiseks GitLab CI/CD-s on mitu valikut. Esimene variant on kasutada sisseehitatud HashiCorp Vault'i.See sobib, kui teie meeskond juba kasutab Vault'i oma mandaadi haldamiseks. Veel üks viis, mis sobib, kui teie meeskond haldab autoriseerimist AWS IAM kaudu - veenduge, et tarnimisülesanded käivitatakse GitLab Runner'i, mis on IAM kaudu juurutamiseks autoriseeritud. Aga kui soovite lihtsalt Waypoint'iga tutvuda ja teha seda kiiremini, on viimane variant - lisada oma AWS API ja Secret võtmed GitLab CI/CD keskkonnamuutujatesse AWS_ACCESS_KEY_ID ja AWS_SECRET_ACCESS_KEY.

Kogume kõik kokku

Nüüd, kui oleme autentimisega valmis, saame alustada! Meie lõplik .gitlab-ci.yml näeb välja nagu:

waypoint:
  image: docker:latest
  stage: build
  services:
    - docker:dind
  # Määratlege keskkonnamuutujad, nt `WAYPOINT_VERSION: '0.1.1'`
  variables:
    WAYPOINT_VERSION: ''
    WAYPOINT_SERVER_ADDR: ''
    WAYPOINT_SERVER_TOKEN: ''
    WAYPOINT_SERVER_TLS: '1'
    WAYPOINT_SERVER_TLS_SKIP_VERIFY: '1'
  script:
    - wget -q -O /tmp/waypoint.zip https://releases.hashicorp.com/waypoint/${WAYPOINT_VERSION}/waypoint_${WAYPOINT_VERSION}_linux_amd64.zip
    - unzip -d /usr/local/bin /tmp/waypoint.zip
    - rm -rf /tmp/waypoint*
    - waypoint init
    - waypoint build
    - waypoint deploy
    - waypoint release

Te näete, et me alustame pildiga docker:latest ja seadistame mõned Waypointi jaoks vajalikud keskkonnamuutujad. Jaotises script laadime alla viimase versiooni Waypointi täitmisfailist ja paigaldame selle /usr/local/bin. Kuna meie runner on juba AWS-is autentitud, käivitame edaspidi lihtsalt waypoint init, build, deploy ja release.

Kogumise ülesande väljund näitab meile lõpp-punkti, kuhu me rakenduse deploy’isime:

Waypoint on üks palju HashiCorpi lahendusi, mis töötavad hästi koos GitLabiga. Näiteks peale rakenduse tarnimise saame samal ajal orkestreerida alumist infrastruktuuri kasutades Terraformi GitLabis. SDLC turvalisuse standardiseerimiseks saame samuti integreerida GitLabi Vaultiga salajaste ja tokenite haldamiseks CI/CD torustes, pakkudes terviklikku lahendust arendajatele ja administraatoritele, kes tuginevad salajaste haldusele arengu-, testimis- ja tootmisprotsessides.

HashiCorpi ja GitLabi koostöölahendused aitavad ettevõtetel leida parim viis rakenduste arendamiseks, tagades järjepideva tarnimise juhtimise ja infrastruktuuri. Waypoint on teinud veel ühe edusammu õigesse suunda, ja ootame põnevusega projekti edasist arengut. Rohkem teavet Waypointi kohta leiate siin, samuti tasub uurida dokumentatsioon ja projekti arendusplaani. Oleme meie saadud teadmised lisanud GitLabi CICD dokumentatsiooni. Kui soovite ise kõike töös proovida, saate kogu töökorras näite selles hoidlas..

CI/CD põhimõtete mõistmiseks, GitLab CI kasutamise kõigi nüansside omandamiseks ja parimate praktikate rakendamiseks saate läbitud videokursuse "CI/CD GitLab CI näitel". Liituge!

Allikas: habr.com